Method: changes.watch

Подписывается на изменения для пользователя.

HTTP-запрос

POST https://www.googleapis.com/drive/v3/changes/watch

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

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

Параметры
driveId

string

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

includeCorpusRemovals

boolean

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

includeItemsFromAllDrives

boolean

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

includeRemoved

boolean

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

includeTeamDriveItems
(deprecated)

boolean

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

pageSize

integer

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

pageToken

string

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

restrictToMyDrive

boolean

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

spaces

string

Разделенный запятыми список пространств для запроса в корпусе. Поддерживаемые значения: «диск» и «appDataFolder».

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

teamDriveId
(deprecated)

string

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

includePermissionsForView

string

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

includeLabels

string

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

Тело запроса

Тело запроса содержит экземпляр Channel .

Тело ответа

В случае успеха тело ответа содержит экземпляр Channel .

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

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • 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

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