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

用于在下一页中继续执行上一个列表请求的令牌。此字段应设为来自上一个响应或 getStartPageToken 方法响应的 nextPageToken 的值。
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

要在响应的 labelInfo 部分包含的标签 ID 列表（以英文逗号分隔）。

请求正文

请求正文必须为空。

响应正文

用户更改的列表。

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

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

string (int64 format)

当前最大的更改 ID。
nextPageToken

string

下一页更改的页面令牌。在到达更改列表末尾时，不会显示任何内容。如果令牌因任何原因而被拒绝，则应将其舍弃，并且应从结果的第一页重新开始分页。
kind

string

始终为 drive#changeList。
etag

string

列表的 ETag。
newStartPageToken

string

用于未来更改的起始页令牌。仅当达到当前更改列表的末尾时，此字段才会显示。
items[]

object (Change)

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

授权范围

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

部分范围受到限制，需要经过安全评估才能让应用使用。有关详情，请参阅授权指南。