Если вы используете 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 для 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 Docs
При создании файла в Google Диске вы можете преобразовать некоторые типы файлов в документы Google Документов, Google Таблиц или Google Презентаций. Включите параметры запроса files.insert convert и задайте свойство mimeType (workspace_name) файла. Подробнее см. в разделе Загрузка данных файла .
Общий доступ к файлам, папкам и дискам
Обратите внимание: на странице «Общий доступ к файлам, папкам и дискам» в версии 3 только одно поле, role , определяет действующие роли для пользователя, группы или домена. В версии 2 необходимо, чтобы оба поля разрешения role и additionalRoles — отражали действующие роли пользователя, группы или домена для данного элемента.
Различия в поисковых запросах для версии 2
Поле title версии 2 соответствует name в версии 3. Примеры см. в разделе «Поиск файлов и папок» .
Поле createdDate в версии 2 соответствует createdTime в версии 3. Примеры см. в разделе «Поиск общих дисков» .
Поле modifiedDate версии 2 в версии 3 modifiedTime . Поле lastViewedByMeDate версии 2 в версии 3 заменено на viewedByMeTime . Подробнее см. в разделе Условия и операторы поискового запроса .