共用雲端硬碟與 My Drive API 的差異

共用雲端硬碟會追蹤不同的機構、共用情形和擁有權 直接在「我的雲端硬碟」中匯出模型因此,我們禁止在「我的雲端硬碟」中執行某些「我的雲端硬碟」作業: 共用雲端硬碟中的內容這份文件概述了共用雲端硬碟的專屬規範 API 差異。

Files 資源

系統只會針對共用雲端硬碟中的檔案填入下列欄位:

  • hasAugmentedPermissions:任何使用者是否已獲得檔案存取權 直接儲存這個檔案
  • capabilities/canAddFolderFromAnotherDrive - 目前的使用者是否為 即可將其他雲端硬碟 (不同共用雲端硬碟或「我的雲端硬碟」) 中的資料夾新增至 。
  • capabilities/canDeleteChildren - 目前使用者是否可刪除 。
  • capabilities/canMoveChildrenOutOfDrive - 目前的使用者是否為 可將這個資料夾的子項移至共用雲端硬碟外。
  • capabilities/canMoveChildrenWithinDrive - 目前的使用者是否為 可以在共用雲端硬碟中移動這個資料夾的子項。
  • capabilities/canMoveItemWithinDrive - 目前使用者是否可 將這個共用雲端硬碟項目移至共用雲端硬碟。
  • capabilities/canReadDrive - 目前使用者是否已讀取 可以存取這個檔案所屬的共用雲端硬碟。
  • capabilities/canTrashChildren - 目前的使用者能否移至垃圾桶 。
  • driveId:檔案所屬的共用雲端硬碟 ID 定位。
  • trashingUser:如果檔案遭到明確移至垃圾桶, 已經將其移至垃圾桶。
  • trashedTime:項目移至垃圾桶的時間。

系統不會為共用雲端硬碟中的檔案填入下列欄位:

  • permissions:由於共用雲端硬碟的 ACL 可能大小,因此相關權限 不會做為檔案的一部分傳回。請使用 permissions.list 方法。 支援分頁功能,以便列出檔案內檔案的權限 或共用雲端硬碟本身的設定
  • ownersownerNamesownedByMe - 共用雲端硬碟中的檔案 ,而非個別使用者。
  • folderColorRgb - 無法為資料夾個別加上顏色
  • shared:共用雲端硬碟中的所有項目都會共用。
  • writersCanShare - 目前使用者無法透過以下方式限制共用權限: 角色。

下列欄位僅限使用者獲得檔案存取權時設定 權限:

  • sharedWithMeDate
  • sharingUser

下列欄位與 共用雲端硬碟:

  • parents.isRoot:僅適用於「我的雲端硬碟」根資料夾, 設為 false 則適用於共用雲端硬碟的頂層資料夾。
  • parents:在父項清單中,父項清單不會顯示 要求的使用者不是該共用雲端硬碟的成員,也沒有存取權 傳送到父項此外,除了頂層資料夾外, 如果檔案位於 。

  • capabilities/canRemoveChildren - 使用 capabilities/canDeleteChildrencapabilities/canTrashChildren

Permissions 資源

只有在檔案位於以下位置時,才會填入 permissionDetails 欄位: 。這個欄位是指壓縮權限, 或是沿用這個共用雲端硬碟檔案這個欄位是輸出內容專用欄位, 僅會顯示共用雲端硬碟項目。此外,

  • 已定義 organizerfileOrganizer 的兩個新角色。
  • permissions.list 現在支援分頁。

Changes 資源

下列新欄位在 Changes 資源中提供 共用雲端硬碟:

  • changeType:變更的類型。可能的值為 filedrive
  • driveId:與這項變更相關聯的共用雲端硬碟 ID。
  • drive:共用雲端硬碟的更新狀態。如果 changeType是「drive」,且使用者仍是該共用雲端硬碟的成員。

需要同步的應用程式可能需要進行其他變更 存取任何實用內容,或是追蹤活動。詳情請參閱 追蹤使用者和共用雲端硬碟的變更