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

object ( Change )

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

largestChangeId

string ( int64 format)

Текущий самый большой идентификатор изменения.

nextPageToken

string

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

kind

string

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

etag

string

ETag списка.

newStartPageToken

string

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

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

Требуется одна из следующих областей 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.meet.readonly
  • 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

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