Method: changes.watch

订阅用户的更改。如需了解详情，请参阅资源更改通知。

HTTP 请求

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

网址采用 gRPC 转码语法。

查询参数

参数
driveId

string

将返回更改的共享云端硬盘。如果指定，更改 ID 将反映共享云端硬盘；请使用组合的云端硬盘 ID 和更改 ID 作为标识符。
includeCorpusRemovals

boolean

在请求时，如果用户仍可访问相应文件，更改是否应包含相应文件资源，即使该文件已从更改列表中移除，并且不会再有针对该文件的更改条目。
includeItemsFromAllDrives

boolean

是否应在结果中同时包含“我的云端硬盘”和共享云端硬盘中的内容。
includeRemoved

boolean

是否包含表明相应项已从更改列表中移除的更改，例如因删除或失去访问权限而移除。
includeTeamDriveItems
(deprecated)

boolean

已弃用：请改用 includeItemsFromAllDrives。
pageSize

integer

要返回的更改数量上限。服务返回的值可能小于此值。

如果未指定，则系统最多返回 100 项更改。

最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。
pageToken

string

用于在下一页继续执行之前列表请求的令牌。此参数应设置为上一个响应中的“nextPageToken”值或 getStartPageToken 方法的响应。
restrictToMyDrive

boolean

是否将结果限制为“我的云端硬盘”层次结构中的更改。这样会忽略对文件的更改，例如“应用数据”文件夹中的文件或尚未添加到“我的云端硬盘”中的共享文件。
spaces

string

要在语料库中查询的空间的英文逗号分隔列表。支持的值包括“drive”和“appDataFolder”。
supportsAllDrives

boolean

请求的应用是否同时支持“我的云端硬盘”和共享云端硬盘。
supportsTeamDrives
(deprecated)

boolean

已弃用：请改用 supportsAllDrives。
teamDriveId
(deprecated)

string

已弃用：请改用 driveId。
includePermissionsForView

string

指定要在响应中包含哪些其他视图的权限。仅支持“已发布”。
includeLabels

string

以英文逗号分隔的标签 ID 列表，用于在响应的 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

某些范围受到限制，您的应用需要通过安全评估才能使用这些范围。如需了解详情，请参阅授权指南。