Method: changes.list

列出用户或共享云端硬盘的更改。如需了解详情，请参阅检索更改。

HTTP 请求

GET https://www.googleapis.com/drive/v3/changes

网址采用 gRPC 转码语法。

查询参数

参数
driveId

string

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

boolean

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

boolean

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

boolean

是否包含表明内容已从更改列表中移除的更改，例如通过删除或失去访问权限。
includeTeamDriveItems
(deprecated)

boolean

已弃用：请改用 includeItemsFromAllDrives。
pageSize

integer

每页返回的更改数量上限。
pageToken

string

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

boolean

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

string

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

boolean

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

boolean

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

string

已弃用：请改用 driveId。
includePermissionsForView

string

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

string

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

请求正文

请求正文必须为空。

响应正文

用户的更改列表。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "kind": string,
  "nextPageToken": string,
  "newStartPageToken": string,
  "changes": [
    {
      object (Change)
    }
  ]
}
字段
kind

string

表明这是哪类资源。值：固定字符串 "drive#changeList"。
nextPageToken

string

用于下一页更改的页面令牌。如果已到达更改列表的末尾，则不会显示此字段。页面令牌不会过期。
newStartPageToken

string

用于未来更改的起始页令牌。只有在当前更改列表已到达末尾时，才会显示此标记。页面令牌不会过期。
changes[]

object (Change)

更改列表。如果已填充 nextPageToken，则此列表可能不完整，并且应提取下一页的结果。

授权范围

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

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