Google Drive (v3)

Управление файлами, папками и общими дисками через CLI gws.

Предварительное требование: прочитайте ../gws-shared/SKILL.md для аутентификации, глобальных флагов и правил безопасности. Если файл отсутствует, выполните gws generate-skills.

gws drive <resource> <method> [flags]

Вспомогательные команды

Команда	Описание
+upload	Загрузить файл с автоматическими метаданными

Обнаружение команд

# Просмотр ресурсов и методов
gws drive --help

# Параметры, типы и значения по умолчанию для метода
gws schema drive.<resource>.<method>

Используйте вывод gws schema для построения флагов --params и --json.

API-ресурсы

about

• get — Информация о пользователе, его Drive и возможностях системы. Обязателен параметр fields.

accessproposals

• get — Получить предложение доступа по ID
• list — Список предложений доступа к файлу (только для approver'ов)
• resolve — Одобрить или отклонить предложение доступа

approvals

• get — Получить Approval по ID
• list — Список Approval'ов файла

apps

• get — Получить конкретное приложение
• list — Список установленных приложений пользователя

changes

• getStartPageToken — Получить начальный pageToken для отслеживания изменений
• list — Список изменений пользователя или общего диска
• watch — Подписаться на изменения

channels

• stop — Остановить отслеживание ресурсов через канал

comments

• create — Создать комментарий к файлу. Обязателен параметр fields.
• delete — Удалить комментарий
• get — Получить комментарий по ID. Обязателен параметр fields.
• list — Список комментариев файла. Обязателен параметр fields.
• update — Обновить комментарий (patch semantics). Обязателен параметр fields.

drives

• create — Создать общий диск
• get — Метаданные общего диска по ID
• hide — Скрыть общий диск из представления по умолчанию
• list — Список общих дисков пользователя (поддерживает параметр q для поиска)
• unhide — Восстановить общий диск в представлении по умолчанию
• update — Обновить метаданные общего диска

files

• copy — Создать копию файла с применением обновлений (patch semantics)
• create — Создать файл. Максимальный размер: 5 120 ГБ. MIME: */*
• download — Скачать содержимое файла. Операции действительны 24 часа.
• export — Экспортировать Google Workspace документ в нужный MIME-тип (лимит 10 МБ)
• generateIds — Сгенерировать набор file ID для create/copy запросов
• get — Метаданные или содержимое файла по ID. С параметром alt=media — скачать содержимое.
• list — Список файлов пользователя (поддерживает параметр q; по умолчанию включает удалённые файлы)
• listLabels — Список меток файла
• modifyLabels — Изменить набор меток файла
• update — Обновить метаданные, содержимое или и то, и другое. Максимальный размер: 5 120 ГБ.
• watch — Подписаться на изменения файла

operations

• get — Получить текущее состояние длительной операции (polling)

permissions

Предупреждение: параллельные операции с разрешениями одного файла не поддерживаются — применяется только последнее обновление.

• create — Создать разрешение для файла или общего диска
• delete — Удалить разрешение
• get — Получить разрешение по ID
• list — Список разрешений файла или общего диска
• update — Обновить разрешение (patch semantics)

replies

• create — Создать ответ на комментарий
• delete — Удалить ответ
• get — Получить ответ по ID
• list — Список ответов на комментарий
• update — Обновить ответ (patch semantics)

revisions

• delete — Удалить версию файла (только для бинарного контента — изображений, видео)
• get — Метаданные или содержимое версии по ID
• list — Список версий файла. Для часто редактируемых документов список может быть неполным.
• update — Обновить версию (patch semantics)

teamdrives (устарело)

• create, get, list, update — Устарело; используйте drives.*