Если вы используете 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 в версии v3. Дополнительные сведения см. в разделе Условия и операторы поисковых запросов .