Создание файла на Google Drive через API

Работа с API гугл — это ещё та головоломка, тут переплетены и вечно обновляемые версии API, не прозрачные процедуры авторизации и запутанная консоль разработчика. Сколько уж я писал этих интеграций с гугл, каждый раз охота плеваться.

Но в сторону эмоции, разберем по шагам сохранение файла на диске гугл.

Ожидаемый результат: код на php отправляет данные через API Google Drive, используя сервисную учетную запись, а пользователь Google Drive видит новый файл, который был расшарен сервисной учетной записью.

Библиотеки интеграции

Весь обмен на низким уровне уже реализован компанией Google. Они предоставляют библиотеки для всех разработчиков на разных языках программирования. Нам нужны на PHP.

Авторизация

Чтобы отправлять какие то запросы, нам требуется авторизация. Google Drive API не позволяется использовать авторизацию по API ключу, потому нужно использовать что то более сложное.

Мой выбор — использование ключа сервисной учетной записи. Но обо всём по порядку.

Шаг 1: Создайте приложение в консоли разработчика Google.

Шаг 2: Создайте сервисную учетную запись для этого приложения.

Перейдите к реквизитам приложения:

Там выберите создать реквизиты, тип — сервисный аккаунт:

Каких то особых прав наш аккаунт не требует, т.к. мы не будем трогать данные (файлы) самого пользователя, создающего данный сервисный акк.

Когда сервисная учетка готова, нам потребуется создать приватный ключ.

Во вкладке KEYS — выберите ADD KEY и тип ключа JSON. При создании, гугл выгрузит вам файл ключа. Это не заметный процесс, причем на столько, что многие не понимают: что же потом делать с ключами, так как единственная доступная опция — это удалить ключ, а имя ключа нигде не используется.

В общем, повторно скачать данные ключа в виде JSON файла уже будет нельзя, потому не потеряйте файл :).

Шаг 3. Скачайте или установите в проект (если используете composer) библиотеку от гугл:

composer require google/apiclient

1	composer require google/apiclient

Шаг 4: Авторизация в коде.

Библиотеки подключены, JSON файл скачан, как это использовать в коде?

$client = new Google\Client();
$client->setApplicationName("GOOGLE DRIVE integration");
$client->setAuthConfig(
  $_SERVER['DOCUMENT_ROOT'] . '/../GOOGLE-KEY-FILE.json');
$client->addScope(Google_Service_Drive::DRIVE);
$service = new Google_Service_Drive($client);

$client = new Google\Client();

$client->setApplicationName("GOOGLE DRIVE integration");

$client->setAuthConfig(

$_SERVER['DOCUMENT_ROOT'] . '/../GOOGLE-KEY-FILE.json');

$client->addScope(Google_Service_Drive::DRIVE);

$service = new Google_Service_Drive($client);

Я подключаю файл ключа (GOOGLE-KEY-FILE.json), который сохранил ниже DOCUMENT_ROOT. Вы можете посмотреть, что находится в файле — а это просто JSON-encoded массив переменных. Этот массив можно объявить в коде и передать его вместо имени файла. Так тоже будет работать.

Создание файла на Google Drive

Дальше мы создаём файл. В моём примере это текстовый файл. При этом я конвертирую его сразу же в формат Google Drive Document, чтобы с ним было удобно работать средствами гугл диска.

$fileMetadata = new Google_Service_Drive_DriveFile(array(
  'name' => 'My File.txt',
  'mimeType' => 'application/vnd.google-apps.document'
));

$content = 'СОДЕРЖИМОЕ ТЕКСТОВОГО ФАЙЛА';

$file = $service->files->create($fileMetadata, array(
  'data' => $content,
  'mimeType' => 'text/plain',
  'uploadType' => 'multipart'
));

$fileMetadata = new Google_Service_Drive_DriveFile(array(

'name' => 'My File.txt',

'mimeType' => 'application/vnd.google-apps.document'

));

$content = 'СОДЕРЖИМОЕ ТЕКСТОВОГО ФАЙЛА';

$file = $service->files->create($fileMetadata, array(

'data' => $content,

'mimeType' => 'text/plain',

'uploadType' => 'multipart'

));

Если конвертировать вам не нужно, то используйте другой код:

$fileMetadata = new Google_Service_Drive_DriveFile(array(
   'name' => 'My File without conversion.txt',
));

$content = 'СОДЕРЖИМОЕ ТЕКСТОВОГО ФАЙЛА';

$file = $service->files->create($fileMetadata, array(
  'data' => $content,
  'mimeType' => 'text/plain',
  'uploadType' => 'media'
));

$fileMetadata = new Google_Service_Drive_DriveFile(array(

'name' => 'My File without conversion.txt',

));

$content = 'СОДЕРЖИМОЕ ТЕКСТОВОГО ФАЙЛА';

$file = $service->files->create($fileMetadata, array(

'data' => $content,

'mimeType' => 'text/plain',

'uploadType' => 'media'

));

Выдать разрешение основному пользователю

После этих манипуляций, файл будет создан, но вы не увидите его из под основной учетной записи, т.к. создан он с использованием служебной (service account).

Нужно «расшарить» файл, выдав соответствующие права.

$mail="vasya@google.com";
$type="user";
$role="writer";

$newPermission = new Google_Service_Drive_Permission();
$newPermission->setEmailAddress($mail);
$newPermission->setType($type);
$newPermission->setRole($role);
$service->permissions->create($file->id, $newPermission);

$mail="vasya@google.com";

$type="user";

$role="writer";

$newPermission = new Google_Service_Drive_Permission();

$newPermission->setEmailAddress($mail);

$newPermission->setType($type);

$newPermission->setRole($role);

$service->permissions->create($file->id, $newPermission);

В данном примере права на запись будут выданы пользователю vasya@google.com. Файл станет доступен Васе в разделе «shared with me».

google drive

Написать комментарий

Данная запись опубликована в 10.11.2023 21:59 и размещена в рубрике PHP. Вы можете перейти в конец страницы и оставить ваш комментарий.

Комментарии к «Создание файла на Google Drive через API»

Понравилась статья? Есть вопросы? - пишите в комментариях.

Имя (обязательно)	Е-майл (не будет опубликован на сайте, обязательно для заполнения)
Комментарий: