Method: changes.watch

訂閱使用者的變更。詳情請參閱「資源變更通知」。

HTTP 要求

POST https://www.googleapis.com/drive/v3/changes/watch

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

查詢參數

參數
driveId

string

系統會傳回此共用雲端硬碟的變更。如果指定變更 ID，變更 ID 會反映共用雲端硬碟的變更；請使用合併的雲端硬碟 ID 和變更 ID 做為 ID。
includeCorpusRemovals

boolean

如果使用者在提出要求時仍可存取檔案，即使檔案已從變更清單中移除，且不會再有該檔案的變更項目，變更是否仍應包含檔案資源。
includeItemsFromAllDrives

boolean

是否要在結果中同時納入「我的雲端硬碟」和共用雲端硬碟中的項目。
includeRemoved

boolean

是否要納入表示項目已從變更清單中移除的變更，例如刪除或失去存取權。
includeTeamDriveItems
(deprecated)

boolean

已淘汰：請改用 includeItemsFromAllDrives。
pageSize

integer

要傳回的變更數上限。服務傳回的產品數量可能會少於這個值。

如未指定，最多將傳回 100 項變更。

許可的最大值為 1000；超出的數值將一律指定為 1000。
pageToken

string

這個符記可用於接續下一頁的先前清單要求。這項屬性應設為前一個回應中的「nextPageToken」值，或是 getStartPageToken 方法的回應。
restrictToMyDrive

boolean

是否將結果限制為「我的雲端硬碟」階層中的變更。這會省略檔案變更，例如應用程式資料夾中的檔案，或未新增至「我的雲端硬碟」的共用檔案。
spaces

string

以半形逗號分隔的清單，列出要在語料庫中查詢的空間。支援的值為「drive」和「appDataFolder」。
supportsAllDrives

boolean

要求存取的應用程式是否同時支援「我的雲端硬碟」和共用雲端硬碟。
supportsTeamDrives
(deprecated)

boolean

已淘汰：請改用 supportsAllDrives。
teamDriveId
(deprecated)

string

已淘汰：請改用 driveId。
includePermissionsForView

string

指定要在回應中加入哪些額外檢視畫面的權限。僅支援「已發布」。
includeLabels

string

以半形逗號分隔的標籤 ID 清單，這些標籤會納入回應的 labelInfo 部分。

要求主體

要求主體包含 Channel 的例項。

回應主體

如果成功，回應主體會包含 Channel 的執行個體。

授權範圍

需要下列其中一種 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

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