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

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

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

Загрузка и публикация версий файлов

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

Список и загрузка отдельных версий

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

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

Пользовательские свойства файла

Помимо информации на странице «Добавление пользовательских свойств файла» , следующая информация относится только к версии 2:

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

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

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

Дополнительные сведения об ограничениях см. в properties справочной документации.

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

В дополнение к информации на странице поддержки общего диска замените это дополнительное trashedDate на v2.

В разделе «Реализация поддержки общих дисков» для следующих методов требуется 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 Docs, Google Sheets или Google Slides. Включите параметры запроса convert files.insert и установите свойство mimeType (workspace_name) файла. Дополнительную информацию см. в разделе Загрузка данных файла .

Делитесь файлами, папками и дисками

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

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

Поле title v2 — это name в v3. Примеры см. в разделе Поиск файлов и папок .

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

Поле modifiedDate версии 2 имеет modifiedTime в версии 3. Поле lastViewedByMeDate версии 2 viewedByMeTime в версии 3. Дополнительные сведения см. в разделе Условия и операторы поисковых запросов .