Method: changes.list

列出使用者或共用雲端硬碟的異動。

HTTP 要求

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

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

查詢參數

參數
driveId

string

要傳回變更的共用雲端硬碟。如果指定變更 ID,該變更 ID 就會反映共用雲端硬碟;請使用合併的雲端硬碟 ID 和變更 ID 做為 ID。

includeCorpusRemovals

boolean

如果在提出要求時,使用者仍可存取該檔案,變更是否應包含檔案資源,即使檔案已從變更清單中移除,且這個檔案也沒有其他變更項目也一樣。

includeItemsFromAllDrives

boolean

是否同時包含「我的雲端硬碟」和共用雲端硬碟項目。

includeRemoved

boolean

是否包含變更,指出項目已從變更清單中移除,例如刪除或失去存取權。

includeTeamDriveItems
(deprecated)

boolean

已淘汰:請改用 includeItemsFromAllDrives

pageSize

integer

每頁傳回的變更數量上限。

pageToken

string

繼續先前在下一頁提出清單要求的權杖。應設為「nextPageToken」的值來自先前的回應或 getStartPageToken 方法的回應。

restrictToMyDrive

boolean

是否僅限在「我的雲端硬碟」階層中變更結果。這項操作會忽略檔案的變更,例如「應用程式資料」資料夾中的檔案,或是尚未新增到「我的雲端硬碟」的共用檔案。

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

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