共用雲端硬碟的組織、共用和擁有權模式與「我的雲端硬碟」不同。因此,您無法對共用雲端硬碟中的內容執行部分「我的雲端硬碟」作業。
本指南將說明 files 和 changes 資源中,共用雲端硬碟專屬的 API 差異。
檔案資源
files 資源中的下列欄位只會填入共用雲端硬碟中的檔案:
hasAugmentedPermissions:是否有任何使用者直接取得這個檔案的存取權。capabilities/canAddFolderFromAnotherDrive:目前使用者是否可將其他雲端硬碟 (其他共用雲端硬碟或「我的雲端硬碟」) 中的資料夾新增至這個資料夾。capabilities/canDeleteChildren:目前使用者是否可以刪除這個資料夾的子項。capabilities/canMoveChildrenOutOfDrive:目前使用者是否可將這個資料夾的子項移出共用雲端硬碟。capabilities/canMoveChildrenWithinDrive:目前使用者是否可以在共用雲端硬碟中移動這個資料夾的子項。capabilities/canMoveItemWithinDrive:目前使用者是否可以在共用雲端硬碟中移動這個項目。capabilities/canReadDrive:目前使用者是否具有檔案所屬共用雲端硬碟的讀取權限。capabilities/canTrashChildren:目前使用者是否可以將這個資料夾的子項移至垃圾桶。driveId:檔案所在的共用雲端硬碟 ID。trashingUser:如果檔案已明確移至垃圾桶,則為移至垃圾桶的使用者。trashedTime:項目遭刪除的時間。如果您使用舊版 Drive API v2,這個欄位稱為trashedDate。
如果檔案位於共用雲端硬碟中,系統不會填入下列欄位:
permissions:由於共用雲端硬碟存取控制清單 (ACL) 可能很大,因此權限不會做為檔案的一部分傳回。使用permissions.list方法 (支援分頁),列出共用雲端硬碟或共用雲端硬碟資料夾中檔案的權限。owners、ownerNames、ownedByMe:共用雲端硬碟中的檔案歸共用雲端硬碟所有,而非個別使用者。folderColorRgb:資料夾無法個別上色。shared:共用雲端硬碟中的所有項目都會共用。writersCanShare:您無法在共用雲端硬碟中依角色限制共用。
只有在使用者獲得項目的檔案存取權時,系統才會設定下列欄位:
sharedWithMeDatesharingUser
與共用雲端硬碟搭配使用時,請特別注意下列欄位:
parents.isRoot:這個欄位只適用於「我的雲端硬碟」根資料夾,共用雲端硬碟頂層資料夾則不適用。parents:如果要求者不是共用雲端硬碟的成員,且無法存取上層資料夾,則上層資料夾不會顯示在父項清單中。此外,如果檔案位於共用雲端硬碟中,則除了頂層資料夾外,父項清單只能包含一個項目。capabilities/canRemoveChildren:使用capabilities/canDeleteChildren或capabilities/canTrashChildren。
變更資源
共用雲端硬碟的 changes 資源現在提供下列新欄位:
changeType:變更類型。可能的值為file和drive。driveId:與這項變更相關聯的共用雲端硬碟 ID。drive:共用雲端硬碟的更新狀態。如果changeType是drive,且使用者仍是共用雲端硬碟的成員,則會顯示。
如果應用程式需要與共用雲端硬碟同步處理內容或追蹤活動,可能需要進行額外變更。詳情請參閱「追蹤使用者和共用雲端硬碟的變更」。