Permissions

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

如需本資源的方法清單，請見本頁結尾。

資源表示法

檔案的權限。權限可授予使用者、群組、網域或全世界的使用者存取檔案或資料夾的權限。

{
  "kind": "drive#permission",
  "id": string,
  "type": string,
  "emailAddress": string,
  "domain": string,
  "role": string,
  "view": string,
  "allowFileDiscovery": boolean,
  "displayName": string,
  "photoLink": string,
  "expirationTime": datetime,
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "role": string,
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "permissionDetails": [
    {
      "permissionType": string,
      "role": string,
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "deleted": boolean,
  "pendingOwner": boolean
}
資源名稱 值 說明 Notes
kind string 識別資源的類型。值：固定字串 "drive#permission"。
id string 這項權限的 ID。這是受益人的專屬 ID，會在使用者資源中以 permissionId 發布。系統會將 ID 視為不透明的值。
type string 受益人的類型。有效值為：
  • user
  • group
  • domain
  • anyone
建立權限時，如果 type 為 user 或 group，您必須為使用者或群組提供 emailAddress。當 type 為 domain 時，您必須提供 domain。您不須提供 anyone 類型的額外資訊。		 可寫入
emailAddress string 這個權限所參照的使用者或群組的電子郵件地址。 可寫入
domain string 權限所參照的網域。目前可用選項如下：
  • 整個網域，例如「<貴公司名稱>.com」。
  • 目標對象，例如「ID.audience.googledomain..com」。
 可寫入
role string 授予此角色的角色。目前我們可能支援新值，但目前允許下列值：
  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
 可寫入
allowFileDiscovery boolean 權限是否允許使用者透過搜尋功能找到檔案。這僅適用於 domain 或 anyone 類型的權限。 可寫入
displayName string 權限值的「美麗」名稱。以下是各種權限的範例：
  • user - 使用者的 Google 帳戶所定義的全名，例如「王大明」。
  • group：Google 網路論壇的名稱，例如「公司管理員」。
  • domain：字串網域名稱，例如「<貴公司名稱>.com」。
  • anyone - 沒有任何 displayName。
expirationTime datetime 權限到期的時間 (RFC 3339 日期時間)。到期時間有下列限制：
  • 無法在共用雲端硬碟項目中設定這些項目。
  • 您只能針對使用者和群組設定權限。
  • 時間必須設在未來。
  • 時間不得設在一年之內。
 可寫入
teamDrivePermissionDetails[] list 已淘汰 - 請改用 permissionDetails。
teamDrivePermissionDetails[].teamDrivePermissionType string 已淘汰 - 請改用 permissionDetails/permissionType。
teamDrivePermissionDetails[].role string 已淘汰 - 請改用 permissionDetails/role。
teamDrivePermissionDetails[].inheritedFrom string 已淘汰 - 請改用 permissionDetails/inheritedFrom。
teamDrivePermissionDetails[].inherited boolean 已淘汰 - 請改用 permissionDetails/inherited。
deleted boolean 與這個權限相關聯的帳戶是否已刪除。這個欄位僅適用於使用者和群組權限。
permissionDetails[] list 關於這個共用雲端硬碟項目的權限是沿用還是直接取得。這個僅限輸出的欄位僅適用於共用雲端硬碟項目。
permissionDetails[].permissionType string 這位使用者的權限類型。目前可加入新值，但目前允許下列值：
  • file
  • member
permissionDetails[].role string 這位使用者的主要角色。目前未來可能會加入新的值，但目前允許下列值：
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
permissionDetails[].inheritedFrom string 沿用這個權限項目的項目 ID。此為僅限輸出的欄位。
permissionDetails[].inherited boolean 是否沿用此權限。這個欄位一律會填入資料。此為僅限輸出的欄位。
view string 表示這項權限的檢視畫面。只有屬於檢視畫面的權限才會填入資料。published 是唯一支援的值。 可寫入
pendingOwner boolean 與此權限相關聯的帳戶是否為待審核的擁有者。系統只會針對非共用雲端硬碟中的檔案填入 user 類型權限。 可寫入

方法

建立
建立檔案或共用雲端硬碟的權限。如要進一步瞭解如何建立權限，請參閱共用檔案、資料夾和雲端硬碟一文。
刪除
刪除權限。
取得
透過 ID 取得權限。
list
列出檔案或共用雲端硬碟的權限。
更新
使用修補語意更新權限。