REST Resource: permissions

{
  "id": string,
  "displayName": string,
  "type": string,
  "kind": string,
  "permissionDetails": [
    {
      "permissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "photoLink": string,
  "emailAddress": string,
  "role": string,
  "allowFileDiscovery": boolean,
  "domain": string,
  "expirationTime": string,
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean
}

string

僅供輸出。這項權限的 ID。這是授予對象的專屬 ID，並以 permissionId 的形式發布在使用者資源中。ID 應視為不透明值。

string

僅供輸出。「美化」權限值的名稱。以下列出每種權限類型的範例：

• user - 使用者在 Google 帳戶中定義的全名，例如「王大明」。
• group - Google 群組名稱，例如「公司管理員」。
• domain - 字串網域名稱，例如「thecompany.com」。
• anyone - 沒有 displayName。

string

授予對象的類型。有效值如下：

• user
• group
• domain
• anyone

如果 type 是 user 或 group，當您建立權限時，您必須為使用者或群組提供 emailAddress。當 type 為 domain 時，您必須提供 domain。您不需要為 anyone 類型提供額外資訊。

string

僅供輸出。標示資源的種類。值：固定字串 "drive#permission"。

object

僅供輸出。詳細說明這個共用雲端硬碟項目的權限是沿用設定，還是直接套用至這個項目。這個僅輸出欄位，僅適用於共用雲端硬碟項目。

string

僅供輸出。這位使用者的權限類型，雖然日後可能會加入新值，目前還有下列幾種：

• file
• member

string

僅供輸出。繼承這項權限的項目 ID。這是一個僅限輸出的欄位。

string

僅供輸出。這位使用者的主要角色，雖然日後可能會加入新值，目前還有下列幾種：

• organizer
• fileOrganizer
• writer
• commenter
• reader

boolean

僅供輸出。是否沿用這項權限。系統會一律在這個欄位填入資料。這是一個僅限輸出的欄位。

string

僅供輸出。使用者個人資料相片的連結 (如有)。

string

這個權限參照的使用者或群組的電子郵件地址。

string

這個權限授予的角色。我們日後可能會支援新的值，但目前允許下列值：

• owner
• organizer
• fileOrganizer
• writer
• commenter
• reader

boolean

權限是否允許使用者透過搜尋功能找到檔案。這僅適用於 domain 或 anyone 類型的權限。

string

這項權限參照的網域。

string

這項權限的效期 (RFC 3339 日期時間)。到期時間具有以下限制：

• 並且只能針對使用者和群組權限設定。
• 時間必須設為未來的時間。
• 時間不得早於未來一年。

object

僅供輸出。已淘汰：僅限輸出。請改用 permissionDetails。

string

已淘汰：僅限輸出。請改用 permissionDetails/permissionType。

string

已淘汰：僅限輸出。請改用 permissionDetails/inheritedFrom。

string

已淘汰：僅限輸出。請改用 permissionDetails/role。

boolean

已淘汰：僅限輸出。請改用 permissionDetails/inherited。

boolean

僅供輸出。與這項權限相關聯的帳戶是否已刪除。這個欄位僅適用於使用者和群組權限。

string

指出這項權限的檢視畫面。只會針對屬於資料檢視的權限填入資料。「published」是唯一支援的值。

boolean

與這項權限連結的帳戶是否為待處理擁有者。僅針對非共用雲端硬碟中的檔案填入 user 類型權限。