Method: files.watch

订阅文件的更改。

HTTP 请求

POST https://www.googleapis.com/drive/v2/files/{fileId}/watch

网址采用 gRPC 转码语法。

路径参数

参数
fileId

string

相关文件的 ID。

查询参数

参数
supportsAllDrives

boolean

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

boolean

已弃用：请改用 supportsAllDrives。
acknowledgeAbuse

boolean

用户是否确认下载已知恶意软件或其他滥用文件的风险。只有在 alt 参数设置为 media 且用户是文件的所有者或文件所在共享云端硬盘的组织者时，此操作才适用。
includePermissionsForView

string

指定要在响应中包含哪些其他视图的权限。仅支持 published。
revisionId

string

指定应下载的修订版本 ID。除非指定了 alt=media，否则会被忽略。
updateViewedDate
(deprecated)

boolean

已废弃：请使用 files.update 并将 modifiedDateBehavior 设为 noChange、updateViewedDate 设为 true 并使用空请求正文。
projection
(deprecated)

enum (Projection)

已废弃：此参数没有任何用途。
includeLabels

string

要包含在响应的 labelInfo 部分中的标签 ID 的逗号分隔列表。

请求正文

请求正文包含一个 Channel 实例。

响应正文

如果成功，则响应正文包含一个 Channel 实例。

授权范围

需要以下 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.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

某些镜重受限，您的应用需要接受安全评估才能使用它们。如需了解详情，请参阅授权指南。