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