訂閱使用者的變更。詳情請參閱「資源變更通知」。
HTTP 要求
POST https://www.googleapis.com/drive/v3/changes/watch
這個網址使用 gRPC 轉碼語法。
查詢參數
| 參數 | |
|---|---|
driveId |
系統會傳回共用雲端硬碟的變更內容。如果指定變更 ID，系統會反映共用雲端硬碟；請使用合併的雲端硬碟 ID 和變更 ID 做為 ID。 |
includeCorpusRemovals |
如果使用者在要求時仍可存取檔案，即使檔案已從變更清單中移除，且不會有任何其他變更項目，變更是否應納入檔案資源。 |
includeItemsFromAllDrives |
是否要將「我的雲端硬碟」和共用雲端硬碟的項目納入搜尋結果。 |
includeRemoved |
是否要納入表示項目已從變更清單中移除的變更，例如項目遭到刪除或失去存取權。 |
includeTeamDriveItems |
已淘汰：請改用 |
pageSize |
每頁傳回的變更數量上限。 |
pageToken |
用於在下一頁繼續先前列出要求的符記。這個值應設為上一個回應的「nextPageToken」值，或 getStartPageToken 方法的回應。 |
restrictToMyDrive |
是否要將結果限制在「我的雲端硬碟」階層中的變更。這麼做可省略對檔案的變更，例如應用程式資料資料夾中的檔案，或是尚未新增至「我的雲端硬碟」的共用檔案。 |
spaces |
以半形逗號分隔的清單，列出要查詢的語料庫空間。支援的值為「drive」和「appDataFolder」。 |
supportsAllDrives |
要求的應用程式是否同時支援「我的雲端硬碟」和共用雲端硬碟。 |
supportsTeamDrives |
已淘汰：請改用 |
teamDriveId |
已淘汰：請改用 |
includePermissionsForView |
指定回應中要納入哪些額外檢視畫面的權限。僅支援「已發布」。 |
includeLabels |
以半形逗號分隔的標籤 ID 清單，用於納入回應的 |
要求主體
要求主體包含 Channel 的例項。
回應主體
如果成功，回應主體會包含 Channel 的執行例項。
授權範圍
需要下列其中一種 OAuth 範圍：
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.appdatahttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/drive.meet.readonlyhttps://www.googleapis.com/auth/drive.metadatahttps://www.googleapis.com/auth/drive.metadata.readonlyhttps://www.googleapis.com/auth/drive.photos.readonlyhttps://www.googleapis.com/auth/drive.readonly
部分權限受限制，應用程式必須通過安全性評估才能使用。詳情請參閱授權指南。