Method: changes.list

列出使用者或共用雲端硬碟的變更。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
driveId

string

系統會傳回此共用雲端硬碟的變更。如果指定變更 ID，系統會反映共用雲端硬碟的變更；請使用合併的雲端硬碟 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

部分範圍受到限制，應用程式必須通過安全性評估才能使用。詳情請參閱授權指南。