Method: changes.list

列出用户或共享云端硬盘的变更。

HTTP 请求

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

网址采用 gRPC 转码语法。

查询参数

参数
driveId

string

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

boolean

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

boolean

是否包含指示已从更改列表中移除项的更改，例如通过删除或失去访问权限。
includeItemsFromAllDrives

boolean

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

boolean

是否在结果中包含“我的云端硬盘”层次结构之外的更改。如果设置为 false，则结果中会省略对文件所做的更改，例如“应用数据”文件夹中的更改或未添加到“我的云端硬盘”的共享文件中的更改。
includeTeamDriveItems
(deprecated)

boolean

已弃用：请改用 includeItemsFromAllDrives。
maxResults

integer

要返回的更改数量上限。
pageToken

string

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

string

要查询的以英文逗号分隔的空间列表。支持的值包括 drive、appDataFolder 和 photos。
startChangeId
(deprecated)

string (int64 format)

已弃用：请改用 pageToken。
supportsAllDrives

boolean

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

boolean

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

string

已弃用：请改用 driveId。
includePermissionsForView

string

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

string

以英文逗号分隔的标签 ID 列表，用于在响应的 labelInfo 部分中包含这些标签。

请求正文

请求正文必须为空。

响应正文

用户的更改列表。

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

JSON 表示法 
{
  "items": [
    {
      object (Change)
    }
  ],
  "largestChangeId": string,
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "newStartPageToken": string,
  "selfLink": string,
  "nextLink": string
}
字段
items[]

object (Change)

更改列表。如果 nextPageToken 已填充，则表示此列表可能不完整，应再提取一页结果。
largestChangeId

string (int64 format)

当前最大的更改 ID。
nextPageToken

string

下一页更改的页面令牌。如果已到达更改列表的末尾，则此字段将不存在。如果令牌因任何原因被拒绝，则应将其舍弃，并从第一页结果重新开始分页。
kind

string

始终为 drive#changeList。
etag

string

列表的 ETag。
newStartPageToken

string

用于未来更改的起始网页令牌。仅当已到达当前更改列表的末尾时才会显示。

授权范围

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

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