Google Drive
Управление файлами, папками и разрешениями
Google Drive — это облачный сервис хранения и синхронизации файлов от Google, который позволяет легко и безопасно хранить, управлять, делиться и получать доступ к файлам на различных устройствах и платформах. Как ключевой элемент Google Workspace, Google Drive предлагает мощные инструменты для организации файлов, совместной работы и бесшовной интеграции с более широким набором инструментов для повышения производительности.
Google Drive позволяет отдельным пользователям и командам:
- Хранить файлы в облаке: Получать доступ к документам, изображениям, видео и другим файлам из любого места с подключением к интернету.
- Организовывать и управлять контентом: Создавать и упорядочивать папки, использовать соглашения об именовании и использовать поиск для быстрого нахождения файлов.
- Делиться и сотрудничать: Контролировать разрешения для файлов и папок, делиться с отдельными пользователями или группами и сотрудничать в реальном времени.
- Использовать мощный поиск: Быстро находить файлы с помощью поисковой технологии Google.
- Получать доступ с различных устройств: Работать с файлами на компьютере, мобильном устройстве или в веб-браузере с полной синхронизацией.
- Глубоко интегрироваться с сервисами Google: Подключаться к Google Docs, Sheets, Slides и партнерским приложениям в ваших рабочих процессах.
В AACFlow интеграция с Google Drive позволяет вашим агентам программно читать, загружать, скачивать, перечислять и организовывать файлы в вашем Drive. Агенты могут автоматизировать управление файлами, оптимизировать рабочие процессы с контентом и включать автоматизацию без кода для хранения и извлечения документов. Подключая AACFlow к Google Drive, вы даете своим агентам возможность включать операции с облачными файлами непосредственно в интеллектуальные бизнес-процессы.
Интегрируйте Google Drive в рабочий процесс. Может создавать, загружать, скачивать, копировать, перемещать, удалять, делиться файлами и управлять разрешениями.
Перечислить файлы и папки в Google Drive с полными метаданными
| Параметр | Тип | Обязательный | Описание |
|---|
folderSelector | string | Нет | ID папки Google Drive для перечисления файлов (например, 1ABCxyz...) |
folderId | string | Нет | ID папки для перечисления файлов (внутреннее использование) |
query | string | Нет | Поисковый термин для фильтрации файлов по имени (например, "budget" находит файлы с "budget" в имени). НЕ используйте синтаксис запросов Google Drive здесь — просто укажите обычный поисковый термин. |
pageSize | number | Нет | Максимальное количество файлов для возврата (по умолчанию: 100) |
pageToken | string | Нет | Токен страницы для постраничной навигации |
| Параметр | Тип | Описание |
|---|
files | array | Массив объектов метаданных файлов из Google Drive |
↳ id | string | ID файла Google Drive |
↳ kind | string | Идентификатор типа ресурса |
↳ name | string | Имя файла |
↳ mimeType | string | MIME-тип |
↳ description | string | Описание файла |
↳ originalFilename | string | Исходное имя загруженного файла |
↳ fullFileExtension | string | Полное расширение файла |
↳ fileExtension | string | Расширение файла |
↳ owners | json | Список владельцев файла |
↳ permissions | json | Разрешения файла |
↳ permissionIds | json | ID разрешений |
↳ shared | boolean | Является ли файл общим |
↳ ownedByMe | boolean | Принадлежит ли текущему пользователю |
↳ writersCanShare | boolean | Могут ли редакторы делиться |
↳ viewersCanCopyContent | boolean | Могут ли зрители копировать |
↳ copyRequiresWriterPermission | boolean | Требуется ли разрешение редактора для копирования |
↳ sharingUser | json | Пользователь, который поделился файлом |
↳ starred | boolean | Является ли файл избранным |
↳ trashed | boolean | Находится ли файл в корзине |
↳ explicitlyTrashed | boolean | Явно ли удален в корзину |
↳ appProperties | json | Свойства приложения |
↳ createdTime | string | Время создания файла |
↳ modifiedTime | string | Время последнего изменения |
↳ modifiedByMeTime | string | Когда изменен текущим пользователем |
↳ viewedByMeTime | string | Когда последний раз просмотрен текущим пользователем |
↳ sharedWithMeTime | string | Когда поделились с текущим пользователем |
↳ lastModifyingUser | json | Пользователь, который последним изменил файл |
↳ viewedByMe | boolean | Просмотрен ли текущим пользователем |
↳ modifiedByMe | boolean | Изменен ли текущим пользователем |
↳ webViewLink | string | URL для просмотра в браузере |
↳ webContentLink | string | Прямая ссылка для скачивания |
↳ iconLink | string | URL значка файла |
↳ thumbnailLink | string | URL миниатюры |
↳ exportLinks | json | Ссылки для экспорта в различные форматы |
↳ size | string | Размер файла в байтах |
↳ quotaBytesUsed | string | Использованная квота хранилища |
↳ md5Checksum | string | MD5 хэш |
↳ sha1Checksum | string | SHA-1 хэш |
↳ sha256Checksum | string | SHA-256 хэш |
↳ parents | json | ID родительских папок |
↳ spaces | json | Пространства, содержащие файл |
↳ driveId | string | ID общего диска |
↳ capabilities | json | Возможности пользователя для файла |
↳ version | string | Номер версии |
↳ headRevisionId | string | ID последней ревизии |
↳ hasThumbnail | boolean | Имеет ли миниатюру |
↳ thumbnailVersion | string | Версия миниатюры |
↳ imageMediaMetadata | json | Метаданные для изображений |
↳ videoMediaMetadata | json | Метаданные для видео |
↳ isAppAuthorized | boolean | Создан ли запрашивающим приложением |
↳ contentRestrictions | json | Ограничения контента |
↳ linkShareMetadata | json | Метаданные для обмена ссылками |
nextPageToken | string | Токен для получения следующей страницы результатов |
Получить метаданные для конкретного файла в Google Drive по его ID
| Параметр | Тип | Обязательный | Описание |
|---|
fileId | string | Да | ID файла для получения |
| Параметр | Тип | Описание |
|---|
file | json | Метаданные файла |
↳ id | string | ID файла Google Drive |
↳ kind | string | Идентификатор типа ресурса |
↳ name | string | Имя файла |
↳ mimeType | string | MIME-тип |
↳ description | string | Описание файла |
↳ size | string | Размер файла в байтах |
↳ starred | boolean | Является ли файл избранным |
↳ trashed | boolean | Находится ли файл в корзине |
↳ webViewLink | string | URL для просмотра в браузере |
↳ webContentLink | string | Прямая ссылка для скачивания |
↳ iconLink | string | URL значка файла |
↳ thumbnailLink | string | URL миниатюры |
↳ parents | json | ID родительских папок |
↳ owners | json | Список владельцев файла |
↳ permissions | json | Разрешения файла |
↳ createdTime | string | Время создания файла |
↳ modifiedTime | string | Время последнего изменения |
↳ lastModifyingUser | json | Пользователь, который последним изменил файл |
↳ shared | boolean | Является ли файл общим |
↳ ownedByMe | boolean | Принадлежит ли текущему пользователю |
↳ capabilities | json | Возможности пользователя для файла |
↳ md5Checksum | string | MD5 хэш |
↳ version | string | Номер версии |
Создать новую папку в Google Drive с возвратом полных метаданных
| Параметр | Тип | Обязательный | Описание |
|---|
fileName | string | Да | Имя создаваемой папки |
folderSelector | string | Нет | ID родительской папки Google Drive для создания папки (например, 1ABCxyz...) |
folderId | string | Нет | ID родительской папки (внутреннее использование) |
| Параметр | Тип | Описание |
|---|
file | object | Полные метаданные созданной папки из Google Drive |
↳ id | string | ID папки Google Drive |
↳ kind | string | Идентификатор типа ресурса |
↳ name | string | Имя папки |
↳ mimeType | string | MIME-тип (application/vnd.google-apps.folder) |
↳ description | string | Описание папки |
↳ owners | json | Список владельцев папки |
↳ permissions | json | Разрешения папки |
↳ permissionIds | json | ID разрешений |
↳ shared | boolean | Является ли папка общей |
↳ ownedByMe | boolean | Принадлежит ли текущему пользователю |
↳ writersCanShare | boolean | Могут ли редакторы делиться |
↳ viewersCanCopyContent | boolean | Могут ли зрители копировать |
↳ copyRequiresWriterPermission | boolean | Требуется ли разрешение редактора для копирования |
↳ sharingUser | json | Пользователь, который поделился папкой |
↳ starred | boolean | Является ли папка избранной |
↳ trashed | boolean | Находится ли папка в корзине |
↳ explicitlyTrashed | boolean | Явно ли удалена в корзину |
↳ appProperties | json | Свойства приложения |
↳ folderColorRgb | string | Цвет папки |
↳ createdTime | string | Время создания папки |
↳ modifiedTime | string | Время последнего изменения |
↳ modifiedByMeTime | string | Когда изменена текущим пользователем |
↳ viewedByMeTime | string | Когда последний раз просмотрена текущим пользователем |
↳ sharedWithMeTime | string | Когда поделились с текущим пользователем |
↳ lastModifyingUser | json | Пользователь, который последним изменил папку |
↳ viewedByMe | boolean | Просмотрена ли текущим пользователем |
↳ modifiedByMe | boolean | Изменена ли текущим пользователем |
↳ webViewLink | string | URL для просмотра в браузере |
↳ iconLink | string | URL значка папки |
↳ parents | json | ID родительских папок |
↳ spaces | json | Пространства, содержащие папку |
↳ driveId | string | ID общего диска |
↳ capabilities | json | Возможности пользователя для папки |
↳ version | string | Номер версии |
↳ isAppAuthorized | boolean | Создана ли запрашивающим приложением |
↳ contentRestrictions | json | Ограничения контента |
↳ linkShareMetadata | json | Метаданные для обмена ссылками |
Загрузить файл в Google Drive с возвратом полных метаданных
| Параметр | Тип | Обязательный | Описание |
|---|
fileName | string | Да | Имя файла для загрузки |
file | file | Нет | Бинарный файл для загрузки (объект UserFile) |
content | string | Нет | Текстовое содержимое для загрузки (используйте ЭТО ИЛИ file, но не оба) |
mimeType | string | Нет | MIME-тип файла для загрузки (автоматически определяется из файла, если не указан) |
folderSelector | string | Нет | ID папки Google Drive для загрузки файла (например, 1ABCxyz...) |
folderId | string | Нет | ID папки для загрузки файла (внутреннее использование) |
| Параметр | Тип | Описание |
|---|
file | object | Полные метаданные загруженного файла из Google Drive |
↳ id | string | ID файла Google Drive |
↳ kind | string | Идентификатор типа ресурса |
↳ name | string | Имя файла |
↳ mimeType | string | MIME-тип |
↳ description | string | Описание файла |
↳ originalFilename | string | Исходное имя загруженного файла |
↳ fullFileExtension | string | Полное расширение файла |
↳ fileExtension | string | Расширение файла |
↳ owners | json | Список владельцев файла |
↳ permissions | json | Разрешения файла |
↳ permissionIds | json | ID разрешений |
↳ shared | boolean | Является ли файл общим |
↳ ownedByMe | boolean | Принадлежит ли текущему пользователю |
↳ writersCanShare | boolean | Могут ли редакторы делиться |
↳ viewersCanCopyContent | boolean | Могут ли зрители копировать |
↳ copyRequiresWriterPermission | boolean | Требуется ли разрешение редактора для копирования |
↳ sharingUser | json | Пользователь, который поделился файлом |
↳ starred | boolean | Является ли файл избранным |
↳ trashed | boolean | Находится ли файл в корзине |
↳ explicitlyTrashed | boolean | Явно ли удален в корзину |
↳ appProperties | json | Свойства приложения |
↳ createdTime | string | Время создания файла |
↳ modifiedTime | string | Время последнего изменения |
↳ modifiedByMeTime | string | Когда изменен текущим пользователем |
↳ viewedByMeTime | string | Когда последний раз просмотрен текущим пользователем |
↳ sharedWithMeTime | string | Когда поделились с текущим пользователем |
↳ lastModifyingUser | json | Пользователь, который последним изменил файл |
↳ viewedByMe | boolean | Просмотрен ли текущим пользователем |
↳ modifiedByMe | boolean | Изменен ли текущим пользователем |
↳ webViewLink | string | URL для просмотра в браузере |
↳ webContentLink | string | Прямая ссылка для скачивания |
↳ iconLink | string | URL значка файла |
↳ thumbnailLink | string | URL миниатюры |
↳ exportLinks | json | Ссылки для экспорта в различные форматы |
↳ size | string | Размер файла в байтах |
↳ quotaBytesUsed | string | Использованная квота хранилища |
↳ md5Checksum | string | MD5 хэш |
↳ sha1Checksum | string | SHA-1 хэш |
↳ sha256Checksum | string | SHA-256 хэш |
↳ parents | json | ID родительских папок |
↳ spaces | json | Пространства, содержащие файл |
↳ driveId | string | ID общего диска |
↳ capabilities | json | Возможности пользователя для файла |
↳ version | string | Номер версии |
↳ headRevisionId | string | ID последней ревизии |
↳ hasThumbnail | boolean | Имеет ли миниатюру |
↳ thumbnailVersion | string | Версия миниатюры |
↳ imageMediaMetadata | json | Метаданные для изображений |
↳ videoMediaMetadata | json | Метаданные для видео |
↳ isAppAuthorized | boolean | Создан ли запрашивающим приложением |
↳ contentRestrictions | json | Ограничения контента |
↳ linkShareMetadata | json | Метаданные для обмена ссылками |
Скачать файл из Google Drive с полными метаданными (автоматически экспортирует файлы Google Workspace)
| Параметр | Тип | Обязательный | Описание |
|---|
fileId | string | Да | ID файла для скачивания |
mimeType | string | Нет | MIME-тип для экспорта файлов Google Workspace (опционально) |
fileName | string | Нет | Опциональное переопределение имени файла |
includeRevisions | boolean | Нет | Включать ли историю ревизий в метаданные (по умолчанию: true, возвращает первые 100 ревизий) |
| Параметр | Тип | Описание |
|---|
file | file | Скачанный файл, сохраненный в файлах выполнения |
metadata | object | Полные метаданные файла из Google Drive |
↳ id | string | ID файла Google Drive |
↳ kind | string | Идентификатор типа ресурса |
↳ name | string | Имя файла |
↳ mimeType | string | MIME-тип |
↳ description | string | Описание файла |
↳ originalFilename | string | Исходное имя загруженного файла |
↳ fullFileExtension | string | Полное расширение файла |
↳ fileExtension | string | Расширение файла |
↳ owners | json | Список владельцев файла |
↳ permissions | json | Разрешения файла |
↳ permissionIds | json | ID разрешений |
↳ shared | boolean | Является ли файл общим |
↳ ownedByMe | boolean | Принадлежит ли текущему пользователю |
↳ writersCanShare | boolean | Могут ли редакторы делиться |
↳ viewersCanCopyContent | boolean | Могут ли зрители копировать |
↳ copyRequiresWriterPermission | boolean | Требуется ли разрешение редактора для копирования |
↳ sharingUser | json | Пользователь, который поделился файлом |
↳ starred | boolean | Является ли файл избранным |
↳ trashed | boolean | Находится ли файл в корзине |
↳ explicitlyTrashed | boolean | Явно ли удален в корзину |
↳ appProperties | json | Свойства приложения |
↳ createdTime | string | Время создания файла |
↳ modifiedTime | string | Время последнего изменения |
↳ modifiedByMeTime | string | Когда изменен текущим пользователем |
↳ viewedByMeTime | string | Когда последний раз просмотрен текущим пользователем |
↳ sharedWithMeTime | string | Когда поделились с текущим пользователем |
↳ lastModifyingUser | json | Пользователь, который последним изменил файл |
↳ viewedByMe | boolean | Просмотрен ли текущим пользователем |
↳ modifiedByMe | boolean | Изменен ли текущим пользователем |
↳ webViewLink | string | URL для просмотра в браузере |
↳ webContentLink | string | Прямая ссылка для скачивания |
↳ iconLink | string | URL значка файла |
↳ thumbnailLink | string | URL миниатюры |
↳ exportLinks | json | Ссылки для экспорта в различные форматы |
↳ size | string | Размер файла в байтах |
↳ quotaBytesUsed | string | Использованная квота хранилища |
↳ md5Checksum | string | MD5 хэш |
↳ sha1Checksum | string | SHA-1 хэш |
↳ sha256Checksum | string | SHA-256 хэш |
↳ parents | json | ID родительских папок |
↳ spaces | json | Пространства, содержащие файл |
↳ driveId | string | ID общего диска |
↳ capabilities | json | Возможности пользователя для файла |
↳ version | string | Номер версии |
↳ headRevisionId | string | ID последней ревизии |
↳ hasThumbnail | boolean | Имеет ли миниатюру |
↳ thumbnailVersion | string | Версия миниатюры |
↳ imageMediaMetadata | json | Метаданные для изображений |
↳ videoMediaMetadata | json | Метаданные для видео |
↳ isAppAuthorized | boolean | Создан ли запрашивающим приложением |
↳ contentRestrictions | json | Ограничения контента |
↳ linkShareMetadata | json | Метаданные для обмена ссылками |
↳ revisions | json | История ревизий файла (только первые 100 ревизий) |
Создать копию файла в Google Drive
| Параметр | Тип | Обязательный | Описание |
|---|
fileId | string | Да | ID файла для копирования |
newName | string | Нет | Имя для скопированного файла (по умолчанию: "Копия [оригинальное имя]") |
destinationFolderId | string | Нет | ID папки для размещения копии (по умолчанию: то же место, что и оригинал) |
| Параметр | Тип | Описание |
|---|
file | json | Метаданные скопированного файла |
↳ id | string | ID файла Google Drive копии |
↳ kind | string | Идентификатор типа ресурса |
↳ name | string | Имя файла |
↳ mimeType | string | MIME-тип |
↳ webViewLink | string | URL для просмотра в браузере |
↳ parents | json | ID родительских папок |
↳ createdTime | string | Время создания файла |
↳ modifiedTime | string | Время последнего изменения |
↳ owners | json | Список владельцев файла |
↳ size | string | Размер файла в байтах |
Обновить метаданные файла в Google Drive (переименовать, переместить, добавить в избранное, добавить описание)
| Параметр | Тип | Обязательный | Описание |
|---|
fileId | string | Да | ID файла для обновления |
name | string | Нет | Новое имя файла |
description | string | Нет | Новое описание файла |
addParents | string | Нет | Список ID родительских папок через запятую для добавления (перемещает файл в эти папки) |
removeParents | string | Нет | Список ID родительских папок через запятую для удаления |
starred | boolean | Нет | Добавить файл в избранное или убрать из избранного |
| Параметр | Тип | Описание |
|---|
file | json | Обновленные метаданные файла |
↳ id | string | ID файла Google Drive |
↳ kind | string | Идентификатор типа ресурса |
↳ name | string | Имя файла |
↳ mimeType | string | MIME-тип |
↳ description | string | Описание файла |
↳ starred | boolean | Является ли файл избранным |
↳ webViewLink | string | URL для просмотра в браузере |
↳ parents | json | ID родительских папок |
↳ modifiedTime | string | Время последнего изменения |
Переместить файл в корзину в Google Drive (можно восстановить позже)
| Параметр | Тип | Обязательный | Описание |
|---|
fileId | string | Да | ID файла для перемещения в корзину |
| Параметр | Тип | Описание |
|---|
file | json | Метаданные файла в корзине |
↳ id | string | ID файла Google Drive |
↳ kind | string | Идентификатор типа ресурса |
↳ name | string | Имя файла |
↳ mimeType | string | MIME-тип |
↳ trashed | boolean | Находится ли файл в корзине (должно быть true) |
↳ trashedTime | string | Когда файл был перемещен в корзину |
↳ webViewLink | string | URL для просмотра в браузере |
Окончательно удалить файл из Google Drive (минуя корзину)
| Параметр | Тип | Обязательный | Описание |
|---|
fileId | string | Да | ID файла для окончательного удаления |
| Параметр | Тип | Описание |
|---|
deleted | boolean | Успешно ли удален файл |
fileId | string | ID удаленного файла |
Поделиться файлом с пользователем, группой, доменом или сделать его публичным
| Параметр | Тип | Обязательный | Описание |
|---|
fileId | string | Да | ID файла для общего доступа |
type | string | Да | Тип получателя: user, group, domain или anyone |
role | string | Да | Роль разрешения: owner (передача владения), organizer (только общий диск), fileOrganizer (только общий диск), writer (редактирование), commenter (просмотр и комментирование), reader (только просмотр) |
email | string | Нет | Адрес электронной почты пользователя или группы (обязательно для type=user или type=group) |
domain | string | Нет | Домен для общего доступа (обязательно для type=domain) |
transferOwnership | boolean | Нет | Обязательно, когда роль owner. Передает владение указанному пользователю. |
moveToNewOwnersRoot | boolean | Нет | При передаче владения переместить файл в корневую папку "Мой диск" нового владельца. |
sendNotification | boolean | Нет | Отправлять ли уведомление по электронной почте (по умолчанию: true) |
emailMessage | string | Нет | Пользовательское сообщение для включения в уведомление по электронной почте |
| Параметр | Тип | Описание |
|---|
permission | json | Детали созданного разрешения |
↳ id | string | ID разрешения |
↳ type | string | Тип получателя (user, group, domain, anyone) |
↳ role | string | Роль разрешения |
↳ emailAddress | string | Электронная почта получателя |
↳ displayName | string | Отображаемое имя получателя |
↳ domain | string | Домен получателя |
↳ expirationTime | string | Время истечения срока действия |
↳ deleted | boolean | Удален ли получатель |
Удалить разрешение для файла (отозвать доступ)
| Параметр | Тип | Обязательный | Описание |
|---|
fileId | string | Да | ID файла для изменения разрешений |
permissionId | string | Да | ID разрешения для удаления (используйте list_permissions, чтобы найти это) |
| Параметр | Тип | Описание |
|---|
removed | boolean | Успешно ли удалено разрешение |
fileId | string | ID файла |
permissionId | string | ID удаленного разрешения |
Перечислить все разрешения (кто имеет доступ) для файла в Google Drive
| Параметр | Тип | Обязательный | Описание |
|---|
fileId | string | Да | ID файла для перечисления разрешений |
| Параметр | Тип | Описание |
|---|
permissions | array | Список разрешений для файла |
↳ id | string | ID разрешения (используйте для удаления разрешения) |
↳ type | string | Тип получателя (user, group, domain, anyone) |
↳ role | string | Роль разрешения (owner, organizer, fileOrganizer, writer, commenter, reader) |
↳ emailAddress | string | Электронная почта получателя |
↳ displayName | string | Отображаемое имя получателя |
↳ photoLink | string | URL фотографии получателя |
↳ domain | string | Домен получателя |
↳ expirationTime | string | Когда истекает срок действия разрешения |
↳ deleted | boolean | Удален ли аккаунт получателя |
↳ allowFileDiscovery | boolean | Может ли получатель обнаружить файл |
↳ pendingOwner | boolean | Ожидает ли передача владения |
↳ permissionDetails | json | Детали о наследуемых разрешениях |
nextPageToken | string | Токен для получения следующей страницы разрешений |
Получить информацию о пользователе и его Google Drive (квота хранилища, возможности)
| Параметр | Тип | Обязательный | Описание |
|---|
| Параметр | Тип | Описание |
|---|
user | json | Информация об аутентифицированном пользователе |
↳ displayName | string | Отображаемое имя пользователя |
↳ emailAddress | string | Адрес электронной почты пользователя |
↳ photoLink | string | URL фотографии профиля пользователя |
↳ permissionId | string | ID разрешения пользователя |
↳ me | boolean | Является ли это аутентифицированным пользователем |
storageQuota | json | Информация о квоте хранилища в байтах |
↳ limit | string | Общий лимит хранилища в байтах (null для неограниченного) |
↳ usage | string | Общее используемое хранилище в байтах |
↳ usageInDrive | string | Хранилище, используемое файлами Drive, в байтах |
↳ usageInDriveTrash | string | Хранилище, используемое файлами в корзине, в байтах |
canCreateDrives | boolean | Может ли пользователь создавать общие диски |
importFormats | json | Карта MIME-типов, которые можно импортировать, и их целевые форматы |
exportFormats | json | Карта MIME-типов Google Workspace и их экспортируемые форматы |
maxUploadSize | string | Максимальный размер загрузки в байтах |