Руководство по Drive API v2

Если вы используете Google Drive API версии 2, большая часть контента в руководстве по Google Drive API версии 3 также относится к версии 2. В этом разделе содержится вся информация, относящаяся к версии 2 и отличающаяся от того, что показано на определенных страницах руководства по версии 3. Чтобы получить полное представление, каждый подраздел содержит ссылку на соответствующую страницу руководства.

Полный список различий приведен в справочнике по сравнению Drive API v2 и v3.

Как скачивать и публиковать версии файлов

На странице Скачивание и публикация версий файлов следующая информация относится к версии 2 и заменяет разделы, показанные для версии 3:

Как посмотреть список версий и скачать отдельные версии

Получив список версий файла, вы можете скачать содержимое любой из них, отправив авторизованный запрос GET к ее свойству []downloadUrl](/workspace/drive/api/reference/rest/v2/revisions). Google Диск генерирует этот URL с ограниченным сроком действия, когда вы запрашиваете версию. Не полагайтесь на него в будущем.

Вы также можете экспортировать версию в одном из поддерживаемых форматов, проверив свойство exportLinks.

Специальные свойства файлов

В дополнение к информации на странице Как добавить специальные свойства файла, для версии 2 актуальны следующие сведения:

Доступ к ресурсам осуществляется с помощью ресурса properties.

Ниже показана структура типичного свойства, которое может использоваться для хранения идентификатора базы данных файла Диска в файле.

{
  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'
}

Дополнительную информацию о лимитах можно найти в разделе properties справочной документации.

Включить поддержку общих дисков

В дополнение к информации на странице Реализация поддержки общих дисков замените это дополнительное поле trashedDate для версии 2.

В разделе Реализация поддержки общих дисков для работы с контентом общих дисков параметр supportsAllDrives=true требуется в следующих методах:

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

Методы changes.get и changes.list имеют несколько параметров, относящихся к общим дискам. Список параметров приведен в разделе Как отслеживать изменения на общем диске.

Загрузить файлы

На странице Загрузка данных из файла обратите внимание на следующую информацию, которая относится к версии 2:

Импорт в Google Документы

При создании файла на Google Диске вы можете преобразовать некоторые типы файлов в формат Google Документов, Google Таблиц или Google Презентаций. Включите параметры запроса files.insert convert и задайте свойство файла (workspace_name) mimeType. Подробнее о загрузке данных из файла…

Как поделиться файлами, папками и дисками

Обратите внимание, что на странице Как настроить доступ к файлам и папкам в версии 3 только одно поле, role, указывает действующие роли для пользователя, группы или домена. В версии 2 для отражения действующих ролей пользователя, группы или домена в отношении определенного объекта необходимо использовать поля role и additionalRoles разрешения.

Различия в поисковых запросах для версии 2

Поле title из версии 2 в версии 3 называется name. Примеры приведены в статье Как искать файлы и папки.

Поле createdDate из версии 2 в версии 3 называется createdTime. Примеры приведены в разделе Поиск общих дисков.

Поле modifiedDate из версии 2 в версии 3 называется modifiedTime. Поле lastViewedByMeDate в версии 2 соответствует полю viewedByMeTime в версии 3. Подробнее о поисковых запросах и операторах…