Method: changes.list

Перечисляет изменения для пользователя или общего диска.

HTTP-запрос

GET https://www.googleapis.com/drive/v2/changes

URL-адрес использует синтаксис транскодирования gRPC .

Параметры запроса

Параметры
driveId

string

Общий диск, с которого будут возвращены изменения. Если указано, идентификаторы изменений будут отражать общий диск; используйте объединенный идентификатор диска и измените идентификатор в качестве идентификатора.

includeCorpusRemovals

boolean

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

includeDeleted

boolean

Включать ли изменения, указывающие, что элементы были удалены из списка изменений, например, путем удаления или потери доступа.

includeItemsFromAllDrives

boolean

Следует ли включать в результаты как «Мой диск», так и объекты общего диска.

includeSubscribed

boolean

Включать ли в результат изменения за пределами иерархии «Мой диск». Если установлено значение false, изменения в файлах, например файлах в папке «Данные приложения» или общих файлах, которые не были добавлены в «Мой диск», не будут включены в результат.

includeTeamDriveItems
(deprecated)

boolean

Устарело: вместо этого используйте includeItemsFromAllDrives .

maxResults

integer

Максимальное количество возвращаемых изменений.

pageToken

string

Токен для продолжения предыдущего запроса списка на следующей странице. Должно быть установлено значение nextPageToken из предыдущего ответа или ответ метода getStartPageToken.

spaces

string

Список пробелов, разделенных запятыми, для запроса. Поддерживаемые значения: drive , appDataFolder и photos .

startChangeId
(deprecated)

string ( int64 format)

Устарело: вместо этого используйте pageToken .

supportsAllDrives

boolean

Поддерживает ли запрашивающее приложение как «Мои диски», так и общие диски.

supportsTeamDrives
(deprecated)

boolean

Устарело: вместо этого используйте supportsAllDrives .

teamDriveId
(deprecated)

string

Устарело: вместо этого используйте driveId .

includePermissionsForView

string

Указывает, какие дополнительные разрешения представления следует включить в ответ. Поддерживается только published .

includeLabels

string

Список идентификаторов меток, разделенных запятыми, которые нужно включить в часть ответа labelInfo .

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

Список изменений для пользователя.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "largestChangeId": string,
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "newStartPageToken": string,
  "selfLink": string,
  "nextLink": string,
  "items": [
    {
      object (Change)
    }
  ]
}
Поля
largestChangeId

string ( int64 format)

Текущий идентификатор крупнейшего изменения.

nextPageToken

string

Токен страницы для следующей страницы изменений. Этого не будет, если достигнут конец списка изменений. Если токен отклонен по какой-либо причине, его следует отбросить и перезапустить нумерацию страниц с первой страницы результатов.

kind

string

Это всегда drive#changeList .

etag

string

ETag списка.

newStartPageToken

string

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

items[]

object ( Change )

Список изменений. Если параметр nextPageToken заполнен, этот список может быть неполным и необходимо получить дополнительную страницу результатов.

Области авторизации

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.apps.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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