Google Диск (Google Drive)
Загрузка, папки и список файлов Google Диска в процессах Pailot
Google Диск (Google Drive) — облачное хранилище файлов Google. Блок загружает, скачивает, создаёт папки и смотрит список через OAuth (вход по разрешению сервиса).
С Google Диском в Pailot вы можете:
- Загружать файл (бинарный или текст) в выбранную папку
- Создавать папку
- Скачивать файл (файлы Workspace экспортируются автоматически)
- Смотреть список файлов папки с поиском по имени (обычная строка, не синтаксис запросов Диска)
Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Секреты — в переменных окружения рабочего пространства.
Загрузить файл на Диск. В ответе — полные метаданные.
| Параметр | Тип | Обязательный | Описание |
|---|
fileName | string | Да | Имя файла |
file | file | Нет | Бинарный файл (объект UserFile) |
content | string | Нет | Текстовое содержимое (это ИЛИ file, не оба) |
mimeType | string | Нет | MIME-тип (если пусто — определяется по файлу) |
folderSelector | string | Нет | Папка назначения |
folderId | string | Нет | ID папки (служебное поле) |
| Параметр | Тип | Описание |
|---|
file | object | Метаданные загруженного файла |
↳ id | string | ID файла на Диске |
↳ name | string | Имя файла |
↳ mimeType | string | MIME-тип |
↳ kind | string | Тип ресурса |
↳ 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 | Ссылка для просмотра в браузере |
↳ 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 | Метаданные шаринга по ссылке |
Создать папку. В ответе — полные метаданные.
| Параметр | Тип | Обязательный | Описание |
|---|
fileName | string | Да | Имя папки |
folderSelector | string | Нет | Родительская папка |
folderId | string | Нет | ID родительской папки (служебное поле) |
| Параметр | Тип | Описание |
|---|
file | object | Метаданные созданной папки |
↳ id | string | ID папки на Диске |
↳ name | string | Имя папки |
↳ mimeType | string | MIME-тип (application/vnd.google-apps.folder) |
↳ kind | string | Тип ресурса |
↳ 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 | Ссылка для просмотра в браузере |
↳ iconLink | string | URL иконки |
↳ parents | json | ID родительских папок |
↳ spaces | json | Пространства, где лежит папка |
↳ driveId | string | ID общего диска |
↳ capabilities | json | Возможности пользователя по папке |
↳ version | string | Номер версии |
↳ isAppAuthorized | boolean | Создано запрашивающим приложением |
↳ contentRestrictions | json | Ограничения содержимого |
↳ linkShareMetadata | json | Метаданные шаринга по ссылке |
Скачать файл. Файлы Workspace экспортируются автоматически.
| Параметр | Тип | Обязательный | Описание |
|---|
fileId | string | Да | ID файла |
mimeType | string | Нет | MIME-тип экспорта для файлов Workspace |
fileName | string | Нет | Своё имя файла |
includeRevisions | boolean | Нет | Включить историю ревизий (по умолчанию true, первые 100) |
| Параметр | Тип | Описание |
|---|
file | object | Данные скачанного файла |
↳ name | string | Имя файла |
↳ mimeType | string | MIME-тип |
↳ data | string | Содержимое в base64 |
↳ size | number | Размер в байтах |
metadata | object | Полные метаданные файла |
↳ id | string | ID файла на Диске |
↳ name | string | Имя файла |
↳ mimeType | string | MIME-тип |
↳ kind | string | Тип ресурса |
↳ 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 | Ссылка для просмотра в браузере |
↳ 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) |
Список файлов и папок с полными метаданными.
| Параметр | Тип | Обязательный | Описание |
|---|
folderSelector | string | Нет | Папка, из которой смотреть список |
folderId | string | Нет | ID папки (служебное поле) |
query | string | Нет | Поиск по имени (например, budget). Не синтаксис запросов Диска — обычная строка |
pageSize | number | Нет | Максимум файлов (по умолчанию 100) |
pageToken | string | Нет | Токен следующей страницы |
| Параметр | Тип | Описание |
|---|
files | array | Массив метаданных файлов |
↳ id | string | ID файла на Диске |
↳ name | string | Имя файла |
↳ mimeType | string | MIME-тип |
↳ kind | string | Тип ресурса |
↳ 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 | Ссылка для просмотра в браузере |
↳ 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 | Токен следующей страницы |
