資源:雲端硬碟
代表共用雲端硬碟。
部分資源方法 (例如 drives.update
) 需要 driveId
。使用 drives.list
方法擷取共用雲端硬碟的 ID。
JSON 表示法 |
---|
{ "id": string, "name": string, "colorRgb": string, "kind": string, "backgroundImageLink": string, "capabilities": { "canAddChildren": boolean, "canComment": boolean, "canCopy": boolean, "canDeleteDrive": boolean, "canDownload": boolean, "canEdit": boolean, "canListChildren": boolean, "canManageMembers": boolean, "canReadRevisions": boolean, "canRename": boolean, "canRenameDrive": boolean, "canChangeDriveBackground": boolean, "canShare": boolean, "canChangeCopyRequiresWriterPermissionRestriction": boolean, "canChangeDomainUsersOnlyRestriction": boolean, "canChangeDriveMembersOnlyRestriction": boolean, "canChangeSharingFoldersRequiresOrganizerPermissionRestriction": boolean, "canResetDriveRestrictions": boolean, "canDeleteChildren": boolean, "canTrashChildren": boolean }, "themeId": string, "backgroundImageFile": { "id": string, "xCoordinate": number, "yCoordinate": number, "width": number }, "createdTime": string, "hidden": boolean, "restrictions": { "copyRequiresWriterPermission": boolean, "domainUsersOnly": boolean, "driveMembersOnly": boolean, "adminManagedRestrictions": boolean, "sharingFoldersRequiresOrganizerPermission": boolean }, "orgUnitId": string } |
欄位 | |
---|---|
id |
僅供輸出。這個共用雲端硬碟的 ID,也是這個共用雲端硬碟的頂層資料夾 ID。 |
name |
這個共用雲端硬碟的名稱。 |
colorRgb |
這個共用雲端硬碟的顏色,以 RGB 十六進位字串的形式表示。只能在未設定 |
kind |
僅供輸出。識別資源的種類。值:固定字串 |
backgroundImageLink |
僅供輸出。指向這個共用雲端硬碟背景圖片的簡短連結。 |
capabilities |
僅供輸出。這個共用雲端硬碟的目前使用者俱備的功能。 |
capabilities.canAddChildren |
僅供輸出。目前使用者能否將子項新增至這個共用雲端硬碟中的資料夾。 |
capabilities.canComment |
僅供輸出。目前的使用者能否對這個共用雲端硬碟中的檔案加註。 |
capabilities.canCopy |
僅供輸出。目前的使用者能否複製這個共用雲端硬碟中的檔案。 |
capabilities.canDeleteDrive |
僅供輸出。目前的使用者能否刪除這個共用雲端硬碟。如果共用雲端硬碟中含有未移至垃圾桶的項目,嘗試刪除該共用雲端硬碟可能還是會失敗。 |
capabilities.canDownload |
僅供輸出。目前的使用者能否下載這個共用雲端硬碟中的檔案。 |
capabilities.canEdit |
僅供輸出。目前的使用者能否編輯這個共用雲端硬碟中的檔案 |
capabilities.canListChildren |
僅供輸出。目前的使用者能否列出這個共用雲端硬碟中資料夾的子項。 |
capabilities.canManageMembers |
僅供輸出。目前的使用者能否為這個共用雲端硬碟新增成員、移除他們或變更角色。 |
capabilities.canReadRevisions |
僅供輸出。目前的使用者能否讀取這個共用雲端硬碟中檔案的修訂版本資源。 |
capabilities.canRename |
僅供輸出。目前的使用者是否可以重新命名這個共用雲端硬碟中的檔案或資料夾。 |
capabilities.canRenameDrive |
僅供輸出。目前的使用者能否重新命名這個共用雲端硬碟。 |
capabilities.canChangeDriveBackground |
僅供輸出。目前的使用者是否可以變更這個共用雲端硬碟的背景。 |
capabilities.canShare |
僅供輸出。目前的使用者能否將這個共用雲端硬碟中的檔案或資料夾設為共用。 |
capabilities.canChangeCopyRequiresWriterPermissionRestriction |
僅供輸出。目前的使用者是否可以變更這個共用雲端硬碟的「 |
capabilities.canChangeDomainUsersOnlyRestriction |
僅供輸出。目前的使用者是否可以變更這個共用雲端硬碟的「 |
capabilities.canChangeDriveMembersOnlyRestriction |
僅供輸出。目前的使用者是否可以變更這個共用雲端硬碟的「 |
capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction |
僅供輸出。目前的使用者是否可以變更這個共用雲端硬碟的「 |
capabilities.canResetDriveRestrictions |
僅供輸出。目前的使用者能否將共用雲端硬碟限制重設為預設值。 |
capabilities.canDeleteChildren |
僅供輸出。目前的使用者能否從這個共用雲端硬碟的資料夾中刪除子項。 |
capabilities.canTrashChildren |
僅供輸出。目前的使用者是否可以將這個共用雲端硬碟中資料夾中的子項移至垃圾桶。 |
themeId |
要設定背景圖片和顏色的主題 ID。可從 |
backgroundImageFile |
圖片檔和裁剪參數 (已設定這個共用雲端硬碟的背景圖片)。這是寫入專用欄位,只能針對未設定 |
backgroundImageFile.id |
這是 Google 雲端硬碟中用於背景圖片的圖片檔 ID。 |
backgroundImageFile.xCoordinate |
在背景圖片中,裁剪區域左上角的 X 座標。這個值是介於 0 到 1 之間的值。這個值代表從整張圖片左側到裁剪區域左側的水平距離,除以整張圖片的寬度。 |
backgroundImageFile.yCoordinate |
背景圖片裁剪區域左上角的 Y 座標。這個值是介於 0 到 1 之間的值。這個值代表從整張圖片頂端到裁剪區域頂端到裁剪區域頂端的垂直距離,除以整張圖片的高度。 |
backgroundImageFile.width |
裁剪圖片的寬度在 0 到 1 的封閉範圍內。這個值代表裁剪圖片的寬度除以整張圖片的寬度。將寬度套用於高度顯示比例 80 至 9,藉此計算高度。最終產生的圖片寬度至少必須為 1280 像素,高度至少 144 像素。 |
createdTime |
僅供輸出。共用雲端硬碟的建立時間 (RFC 3339 日期和時間)。 |
restrictions |
這組限制適用於這個共用雲端硬碟或這個共用雲端硬碟中的項目。請注意,建立共用雲端硬碟時無法設定限制。如要新增限制,請先建立共用雲端硬碟,再透過「 |
restrictions.copyRequiresWriterPermission |
是否要為檢視者和加註者停用從這個共用雲端硬碟中複製、列印或下載檔案的選項。如果設為 |
restrictions.domainUsersOnly |
這個共用雲端硬碟的存取權以及這個共用雲端硬碟中的項目是否只限於這個共用雲端硬碟所屬的網域使用者。如果這個共用雲端硬碟以外控管的其他共用政策,可能會覆寫這項限制。 |
restrictions.driveMembersOnly |
這個共用雲端硬碟中的項目是否僅限成員存取。 |
restrictions.adminManagedRestrictions |
是否要修改這個共用雲端硬碟的管理員權限。 |
restrictions.sharingFoldersRequiresOrganizerPermission |
設為 True 時,只有具備主辦人角色的使用者才能共用資料夾。如果設為 false,具備「發起人」角色或「檔案管理者」角色的使用者可以共用資料夾。 |
orgUnitId |
僅供輸出。這個共用雲端硬碟的機構單位。只有在 |
方法 |
|
---|---|
|
建立共用雲端硬碟。 |
|
永久刪除使用者處於「organizer 」的共用雲端硬碟。 |
|
根據 ID 取得共用雲端硬碟的中繼資料。 |
|
共用雲端硬碟的預設檢視畫面會隱藏。 |
|
列出使用者的共用雲端硬碟。 |
|
將共用雲端硬碟還原為預設檢視畫面。 |
|
更新共用雲端硬碟的中繼資料。 |