AACFlow

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_list

Перечислить файлы и папки в Google Drive с полными метаданными

Входные параметры

ПараметрТипОбязательныйОписание
folderSelectorstringНетID папки Google Drive для перечисления файлов (например, 1ABCxyz...)
folderIdstringНетID папки для перечисления файлов (внутреннее использование)
querystringНетПоисковый термин для фильтрации файлов по имени (например, "budget" находит файлы с "budget" в имени). НЕ используйте синтаксис запросов Google Drive здесь — просто укажите обычный поисковый термин.
pageSizenumberНетМаксимальное количество файлов для возврата (по умолчанию: 100)
pageTokenstringНетТокен страницы для постраничной навигации

Выходные данные

ПараметрТипОписание
filesarrayМассив объектов метаданных файлов из Google Drive
idstringID файла Google Drive
kindstringИдентификатор типа ресурса
namestringИмя файла
mimeTypestringMIME-тип
descriptionstringОписание файла
originalFilenamestringИсходное имя загруженного файла
fullFileExtensionstringПолное расширение файла
fileExtensionstringРасширение файла
ownersjsonСписок владельцев файла
permissionsjsonРазрешения файла
permissionIdsjsonID разрешений
sharedbooleanЯвляется ли файл общим
ownedByMebooleanПринадлежит ли текущему пользователю
writersCanSharebooleanМогут ли редакторы делиться
viewersCanCopyContentbooleanМогут ли зрители копировать
copyRequiresWriterPermissionbooleanТребуется ли разрешение редактора для копирования
sharingUserjsonПользователь, который поделился файлом
starredbooleanЯвляется ли файл избранным
trashedbooleanНаходится ли файл в корзине
explicitlyTrashedbooleanЯвно ли удален в корзину
appPropertiesjsonСвойства приложения
createdTimestringВремя создания файла
modifiedTimestringВремя последнего изменения
modifiedByMeTimestringКогда изменен текущим пользователем
viewedByMeTimestringКогда последний раз просмотрен текущим пользователем
sharedWithMeTimestringКогда поделились с текущим пользователем
lastModifyingUserjsonПользователь, который последним изменил файл
viewedByMebooleanПросмотрен ли текущим пользователем
modifiedByMebooleanИзменен ли текущим пользователем
webViewLinkstringURL для просмотра в браузере
webContentLinkstringПрямая ссылка для скачивания
iconLinkstringURL значка файла
thumbnailLinkstringURL миниатюры
exportLinksjsonСсылки для экспорта в различные форматы
sizestringРазмер файла в байтах
quotaBytesUsedstringИспользованная квота хранилища
md5ChecksumstringMD5 хэш
sha1ChecksumstringSHA-1 хэш
sha256ChecksumstringSHA-256 хэш
parentsjsonID родительских папок
spacesjsonПространства, содержащие файл
driveIdstringID общего диска
capabilitiesjsonВозможности пользователя для файла
versionstringНомер версии
headRevisionIdstringID последней ревизии
hasThumbnailbooleanИмеет ли миниатюру
thumbnailVersionstringВерсия миниатюры
imageMediaMetadatajsonМетаданные для изображений
videoMediaMetadatajsonМетаданные для видео
isAppAuthorizedbooleanСоздан ли запрашивающим приложением
contentRestrictionsjsonОграничения контента
linkShareMetadatajsonМетаданные для обмена ссылками
nextPageTokenstringТокен для получения следующей страницы результатов

google_drive_get_file

Получить метаданные для конкретного файла в Google Drive по его ID

Входные параметры

ПараметрТипОбязательныйОписание
fileIdstringДаID файла для получения

Выходные данные

ПараметрТипОписание
filejsonМетаданные файла
idstringID файла Google Drive
kindstringИдентификатор типа ресурса
namestringИмя файла
mimeTypestringMIME-тип
descriptionstringОписание файла
sizestringРазмер файла в байтах
starredbooleanЯвляется ли файл избранным
trashedbooleanНаходится ли файл в корзине
webViewLinkstringURL для просмотра в браузере
webContentLinkstringПрямая ссылка для скачивания
iconLinkstringURL значка файла
thumbnailLinkstringURL миниатюры
parentsjsonID родительских папок
ownersjsonСписок владельцев файла
permissionsjsonРазрешения файла
createdTimestringВремя создания файла
modifiedTimestringВремя последнего изменения
lastModifyingUserjsonПользователь, который последним изменил файл
sharedbooleanЯвляется ли файл общим
ownedByMebooleanПринадлежит ли текущему пользователю
capabilitiesjsonВозможности пользователя для файла
md5ChecksumstringMD5 хэш
versionstringНомер версии

google_drive_create_folder

Создать новую папку в Google Drive с возвратом полных метаданных

Входные параметры

ПараметрТипОбязательныйОписание
fileNamestringДаИмя создаваемой папки
folderSelectorstringНетID родительской папки Google Drive для создания папки (например, 1ABCxyz...)
folderIdstringНетID родительской папки (внутреннее использование)

Выходные данные

ПараметрТипОписание
fileobjectПолные метаданные созданной папки из Google Drive
idstringID папки Google Drive
kindstringИдентификатор типа ресурса
namestringИмя папки
mimeTypestringMIME-тип (application/vnd.google-apps.folder)
descriptionstringОписание папки
ownersjsonСписок владельцев папки
permissionsjsonРазрешения папки
permissionIdsjsonID разрешений
sharedbooleanЯвляется ли папка общей
ownedByMebooleanПринадлежит ли текущему пользователю
writersCanSharebooleanМогут ли редакторы делиться
viewersCanCopyContentbooleanМогут ли зрители копировать
copyRequiresWriterPermissionbooleanТребуется ли разрешение редактора для копирования
sharingUserjsonПользователь, который поделился папкой
starredbooleanЯвляется ли папка избранной
trashedbooleanНаходится ли папка в корзине
explicitlyTrashedbooleanЯвно ли удалена в корзину
appPropertiesjsonСвойства приложения
folderColorRgbstringЦвет папки
createdTimestringВремя создания папки
modifiedTimestringВремя последнего изменения
modifiedByMeTimestringКогда изменена текущим пользователем
viewedByMeTimestringКогда последний раз просмотрена текущим пользователем
sharedWithMeTimestringКогда поделились с текущим пользователем
lastModifyingUserjsonПользователь, который последним изменил папку
viewedByMebooleanПросмотрена ли текущим пользователем
modifiedByMebooleanИзменена ли текущим пользователем
webViewLinkstringURL для просмотра в браузере
iconLinkstringURL значка папки
parentsjsonID родительских папок
spacesjsonПространства, содержащие папку
driveIdstringID общего диска
capabilitiesjsonВозможности пользователя для папки
versionstringНомер версии
isAppAuthorizedbooleanСоздана ли запрашивающим приложением
contentRestrictionsjsonОграничения контента
linkShareMetadatajsonМетаданные для обмена ссылками

google_drive_upload

Загрузить файл в Google Drive с возвратом полных метаданных

Входные параметры

ПараметрТипОбязательныйОписание
fileNamestringДаИмя файла для загрузки
filefileНетБинарный файл для загрузки (объект UserFile)
contentstringНетТекстовое содержимое для загрузки (используйте ЭТО ИЛИ file, но не оба)
mimeTypestringНетMIME-тип файла для загрузки (автоматически определяется из файла, если не указан)
folderSelectorstringНетID папки Google Drive для загрузки файла (например, 1ABCxyz...)
folderIdstringНетID папки для загрузки файла (внутреннее использование)

Выходные данные

ПараметрТипОписание
fileobjectПолные метаданные загруженного файла из Google Drive
idstringID файла Google Drive
kindstringИдентификатор типа ресурса
namestringИмя файла
mimeTypestringMIME-тип
descriptionstringОписание файла
originalFilenamestringИсходное имя загруженного файла
fullFileExtensionstringПолное расширение файла
fileExtensionstringРасширение файла
ownersjsonСписок владельцев файла
permissionsjsonРазрешения файла
permissionIdsjsonID разрешений
sharedbooleanЯвляется ли файл общим
ownedByMebooleanПринадлежит ли текущему пользователю
writersCanSharebooleanМогут ли редакторы делиться
viewersCanCopyContentbooleanМогут ли зрители копировать
copyRequiresWriterPermissionbooleanТребуется ли разрешение редактора для копирования
sharingUserjsonПользователь, который поделился файлом
starredbooleanЯвляется ли файл избранным
trashedbooleanНаходится ли файл в корзине
explicitlyTrashedbooleanЯвно ли удален в корзину
appPropertiesjsonСвойства приложения
createdTimestringВремя создания файла
modifiedTimestringВремя последнего изменения
modifiedByMeTimestringКогда изменен текущим пользователем
viewedByMeTimestringКогда последний раз просмотрен текущим пользователем
sharedWithMeTimestringКогда поделились с текущим пользователем
lastModifyingUserjsonПользователь, который последним изменил файл
viewedByMebooleanПросмотрен ли текущим пользователем
modifiedByMebooleanИзменен ли текущим пользователем
webViewLinkstringURL для просмотра в браузере
webContentLinkstringПрямая ссылка для скачивания
iconLinkstringURL значка файла
thumbnailLinkstringURL миниатюры
exportLinksjsonСсылки для экспорта в различные форматы
sizestringРазмер файла в байтах
quotaBytesUsedstringИспользованная квота хранилища
md5ChecksumstringMD5 хэш
sha1ChecksumstringSHA-1 хэш
sha256ChecksumstringSHA-256 хэш
parentsjsonID родительских папок
spacesjsonПространства, содержащие файл
driveIdstringID общего диска
capabilitiesjsonВозможности пользователя для файла
versionstringНомер версии
headRevisionIdstringID последней ревизии
hasThumbnailbooleanИмеет ли миниатюру
thumbnailVersionstringВерсия миниатюры
imageMediaMetadatajsonМетаданные для изображений
videoMediaMetadatajsonМетаданные для видео
isAppAuthorizedbooleanСоздан ли запрашивающим приложением
contentRestrictionsjsonОграничения контента
linkShareMetadatajsonМетаданные для обмена ссылками

google_drive_download

Скачать файл из Google Drive с полными метаданными (автоматически экспортирует файлы Google Workspace)

Входные параметры

ПараметрТипОбязательныйОписание
fileIdstringДаID файла для скачивания
mimeTypestringНетMIME-тип для экспорта файлов Google Workspace (опционально)
fileNamestringНетОпциональное переопределение имени файла
includeRevisionsbooleanНетВключать ли историю ревизий в метаданные (по умолчанию: true, возвращает первые 100 ревизий)

Выходные данные

ПараметрТипОписание
filefileСкачанный файл, сохраненный в файлах выполнения
metadataobjectПолные метаданные файла из Google Drive
idstringID файла Google Drive
kindstringИдентификатор типа ресурса
namestringИмя файла
mimeTypestringMIME-тип
descriptionstringОписание файла
originalFilenamestringИсходное имя загруженного файла
fullFileExtensionstringПолное расширение файла
fileExtensionstringРасширение файла
ownersjsonСписок владельцев файла
permissionsjsonРазрешения файла
permissionIdsjsonID разрешений
sharedbooleanЯвляется ли файл общим
ownedByMebooleanПринадлежит ли текущему пользователю
writersCanSharebooleanМогут ли редакторы делиться
viewersCanCopyContentbooleanМогут ли зрители копировать
copyRequiresWriterPermissionbooleanТребуется ли разрешение редактора для копирования
sharingUserjsonПользователь, который поделился файлом
starredbooleanЯвляется ли файл избранным
trashedbooleanНаходится ли файл в корзине
explicitlyTrashedbooleanЯвно ли удален в корзину
appPropertiesjsonСвойства приложения
createdTimestringВремя создания файла
modifiedTimestringВремя последнего изменения
modifiedByMeTimestringКогда изменен текущим пользователем
viewedByMeTimestringКогда последний раз просмотрен текущим пользователем
sharedWithMeTimestringКогда поделились с текущим пользователем
lastModifyingUserjsonПользователь, который последним изменил файл
viewedByMebooleanПросмотрен ли текущим пользователем
modifiedByMebooleanИзменен ли текущим пользователем
webViewLinkstringURL для просмотра в браузере
webContentLinkstringПрямая ссылка для скачивания
iconLinkstringURL значка файла
thumbnailLinkstringURL миниатюры
exportLinksjsonСсылки для экспорта в различные форматы
sizestringРазмер файла в байтах
quotaBytesUsedstringИспользованная квота хранилища
md5ChecksumstringMD5 хэш
sha1ChecksumstringSHA-1 хэш
sha256ChecksumstringSHA-256 хэш
parentsjsonID родительских папок
spacesjsonПространства, содержащие файл
driveIdstringID общего диска
capabilitiesjsonВозможности пользователя для файла
versionstringНомер версии
headRevisionIdstringID последней ревизии
hasThumbnailbooleanИмеет ли миниатюру
thumbnailVersionstringВерсия миниатюры
imageMediaMetadatajsonМетаданные для изображений
videoMediaMetadatajsonМетаданные для видео
isAppAuthorizedbooleanСоздан ли запрашивающим приложением
contentRestrictionsjsonОграничения контента
linkShareMetadatajsonМетаданные для обмена ссылками
revisionsjsonИстория ревизий файла (только первые 100 ревизий)

google_drive_copy

Создать копию файла в Google Drive

Входные параметры

ПараметрТипОбязательныйОписание
fileIdstringДаID файла для копирования
newNamestringНетИмя для скопированного файла (по умолчанию: "Копия [оригинальное имя]")
destinationFolderIdstringНетID папки для размещения копии (по умолчанию: то же место, что и оригинал)

Выходные данные

ПараметрТипОписание
filejsonМетаданные скопированного файла
idstringID файла Google Drive копии
kindstringИдентификатор типа ресурса
namestringИмя файла
mimeTypestringMIME-тип
webViewLinkstringURL для просмотра в браузере
parentsjsonID родительских папок
createdTimestringВремя создания файла
modifiedTimestringВремя последнего изменения
ownersjsonСписок владельцев файла
sizestringРазмер файла в байтах

google_drive_update

Обновить метаданные файла в Google Drive (переименовать, переместить, добавить в избранное, добавить описание)

Входные параметры

ПараметрТипОбязательныйОписание
fileIdstringДаID файла для обновления
namestringНетНовое имя файла
descriptionstringНетНовое описание файла
addParentsstringНетСписок ID родительских папок через запятую для добавления (перемещает файл в эти папки)
removeParentsstringНетСписок ID родительских папок через запятую для удаления
starredbooleanНетДобавить файл в избранное или убрать из избранного

Выходные данные

ПараметрТипОписание
filejsonОбновленные метаданные файла
idstringID файла Google Drive
kindstringИдентификатор типа ресурса
namestringИмя файла
mimeTypestringMIME-тип
descriptionstringОписание файла
starredbooleanЯвляется ли файл избранным
webViewLinkstringURL для просмотра в браузере
parentsjsonID родительских папок
modifiedTimestringВремя последнего изменения

google_drive_trash

Переместить файл в корзину в Google Drive (можно восстановить позже)

Входные параметры

ПараметрТипОбязательныйОписание
fileIdstringДаID файла для перемещения в корзину

Выходные данные

ПараметрТипОписание
filejsonМетаданные файла в корзине
idstringID файла Google Drive
kindstringИдентификатор типа ресурса
namestringИмя файла
mimeTypestringMIME-тип
trashedbooleanНаходится ли файл в корзине (должно быть true)
trashedTimestringКогда файл был перемещен в корзину
webViewLinkstringURL для просмотра в браузере

google_drive_delete

Окончательно удалить файл из Google Drive (минуя корзину)

Входные параметры

ПараметрТипОбязательныйОписание
fileIdstringДаID файла для окончательного удаления

Выходные данные

ПараметрТипОписание
deletedbooleanУспешно ли удален файл
fileIdstringID удаленного файла

google_drive_share

Поделиться файлом с пользователем, группой, доменом или сделать его публичным

Входные параметры

ПараметрТипОбязательныйОписание
fileIdstringДаID файла для общего доступа
typestringДаТип получателя: user, group, domain или anyone
rolestringДаРоль разрешения: owner (передача владения), organizer (только общий диск), fileOrganizer (только общий диск), writer (редактирование), commenter (просмотр и комментирование), reader (только просмотр)
emailstringНетАдрес электронной почты пользователя или группы (обязательно для type=user или type=group)
domainstringНетДомен для общего доступа (обязательно для type=domain)
transferOwnershipbooleanНетОбязательно, когда роль owner. Передает владение указанному пользователю.
moveToNewOwnersRootbooleanНетПри передаче владения переместить файл в корневую папку "Мой диск" нового владельца.
sendNotificationbooleanНетОтправлять ли уведомление по электронной почте (по умолчанию: true)
emailMessagestringНетПользовательское сообщение для включения в уведомление по электронной почте

Выходные данные

ПараметрТипОписание
permissionjsonДетали созданного разрешения
idstringID разрешения
typestringТип получателя (user, group, domain, anyone)
rolestringРоль разрешения
emailAddressstringЭлектронная почта получателя
displayNamestringОтображаемое имя получателя
domainstringДомен получателя
expirationTimestringВремя истечения срока действия
deletedbooleanУдален ли получатель

google_drive_unshare

Удалить разрешение для файла (отозвать доступ)

Входные параметры

ПараметрТипОбязательныйОписание
fileIdstringДаID файла для изменения разрешений
permissionIdstringДаID разрешения для удаления (используйте list_permissions, чтобы найти это)

Выходные данные

ПараметрТипОписание
removedbooleanУспешно ли удалено разрешение
fileIdstringID файла
permissionIdstringID удаленного разрешения

google_drive_list_permissions

Перечислить все разрешения (кто имеет доступ) для файла в Google Drive

Входные параметры

ПараметрТипОбязательныйОписание
fileIdstringДаID файла для перечисления разрешений

Выходные данные

ПараметрТипОписание
permissionsarrayСписок разрешений для файла
idstringID разрешения (используйте для удаления разрешения)
typestringТип получателя (user, group, domain, anyone)
rolestringРоль разрешения (owner, organizer, fileOrganizer, writer, commenter, reader)
emailAddressstringЭлектронная почта получателя
displayNamestringОтображаемое имя получателя
photoLinkstringURL фотографии получателя
domainstringДомен получателя
expirationTimestringКогда истекает срок действия разрешения
deletedbooleanУдален ли аккаунт получателя
allowFileDiscoverybooleanМожет ли получатель обнаружить файл
pendingOwnerbooleanОжидает ли передача владения
permissionDetailsjsonДетали о наследуемых разрешениях
nextPageTokenstringТокен для получения следующей страницы разрешений

google_drive_get_about

Получить информацию о пользователе и его Google Drive (квота хранилища, возможности)

Входные параметры

ПараметрТипОбязательныйОписание

Выходные данные

ПараметрТипОписание
userjsonИнформация об аутентифицированном пользователе
displayNamestringОтображаемое имя пользователя
emailAddressstringАдрес электронной почты пользователя
photoLinkstringURL фотографии профиля пользователя
permissionIdstringID разрешения пользователя
mebooleanЯвляется ли это аутентифицированным пользователем
storageQuotajsonИнформация о квоте хранилища в байтах
limitstringОбщий лимит хранилища в байтах (null для неограниченного)
usagestringОбщее используемое хранилище в байтах
usageInDrivestringХранилище, используемое файлами Drive, в байтах
usageInDriveTrashstringХранилище, используемое файлами в корзине, в байтах
canCreateDrivesbooleanМожет ли пользователь создавать общие диски
importFormatsjsonКарта MIME-типов, которые можно импортировать, и их целевые форматы
exportFormatsjsonКарта MIME-типов Google Workspace и их экспортируемые форматы
maxUploadSizestringМаксимальный размер загрузки в байтах

On this page

Начните создавать сегодня
Нам доверяют более 100 000 разработчиков.
SaaS-платформа для создания AI-агентов и управления агентным workforce.
Начать