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

Максимальное количество изменений, которое может быть возвращено. Сервис может вернуть меньшее значение.

Если параметр не указан, будет возвращено не более 100 изменений.

Максимальное значение — 1000; значения выше 1000 будут принудительно уменьшены до 1000.

pageToken

string

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

restrictToMyDrive

boolean

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

spaces

string

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

teamDriveId
(deprecated)

string

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

includePermissionsForView

string

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

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.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

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