列出使用者或共用雲端硬碟的異動。
HTTP 要求
GET https://www.googleapis.com/drive/v3/changes
這個網址使用 gRPC 轉碼語法。
查詢參數
參數 | |
---|---|
driveId |
要傳回變更的共用雲端硬碟。如果指定變更 ID,系統會將變更 ID 反映共用雲端硬碟,請使用合併雲端硬碟 ID 和變更 ID 做為 ID。 |
includeCorpusRemovals |
如果在要求時,使用者仍可存取檔案,則變更是否應包含檔案資源,即使已將檔案從變更清單中移除且這個檔案沒有其他變更項目也一樣。 |
includeItemsFromAllDrives |
搜尋結果是否應包含「我的雲端硬碟」和「共用雲端硬碟」項目。 |
includeRemoved |
是否要納入變更,指出項目已從變更清單中移除,例如刪除或失去存取權。 |
includeTeamDriveItems |
已淘汰:請改用 |
pageSize |
每頁傳回的變更數量上限。 |
pageToken |
用於繼續先前在下一頁列出要求所需的權杖。應設為前一個回應的「nextPageToken」值或 getStartPageToken 方法的回應。 |
restrictToMyDrive |
是否要將結果限制在「我的雲端硬碟」階層中的變更。這樣就能略過對「應用程式資料」資料夾中的檔案或尚未新增至「我的雲端硬碟」的共用檔案所做的變更。 |
spaces |
要在語料庫中查詢的空格 (以半形逗號分隔)。支援的值為「drive」和「appDataFolder」。 |
supportsAllDrives |
提出要求的應用程式是否支援「我的雲端硬碟」和共用雲端硬碟。 |
supportsTeamDrives |
已淘汰:請改用 |
teamDriveId |
已淘汰:請改用 |
includePermissionsForView |
指定要在回應中加入哪些額外檢視畫面權限。僅支援「已發布」。 |
includeLabels |
要包含在回應的 |
要求主體
要求主體必須為空白。
回應主體
使用者的變更清單。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"kind": string,
"nextPageToken": string,
"newStartPageToken": string,
"changes": [
{
object ( |
欄位 | |
---|---|
kind |
指出資源的類型。值:固定字串 |
nextPageToken |
下一頁變更的頁面權杖。如果已完成變更清單,則不會發生這種情況。網頁權杖不會過期。 |
newStartPageToken |
用於日後變更的起始頁面符記。只有在目前變更清單已屆滿時,才會出現這個 ID。網頁權杖不會過期。 |
changes[] |
變更清單。如果填入 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.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive.readonly
部分範圍受到限制,應用程式必須進行安全性評估,才能使用這些範圍。詳情請參閱授權指南。