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