本頁面由 Cloud Translation API 翻譯而成。

REST Resource: permissions

資源：權限
- JSON 表示法
方法

資源：權限

檔案的權限。使用者、群組、網域或全球都能存取檔案或資料夾的階層。

部分資源方法 (例如 permissions.update) 需要 permissionId。使用 permissions.list 方法擷取檔案、資料夾或共用雲端硬碟的 ID。

JSON 表示法
{ "id": string, "name": string, "type": string, "role": string, "additionalRoles": [ string ], "authKey": string, "value": string, "kind": string, "withLink": boolean, "photoLink": string, "selfLink": string, "emailAddress": string, "domain": string, "etag": string, "permissionDetails": [ { "permissionType": string, "role": string, "additionalRoles": [ string ], "inheritedFrom": string, "inherited": boolean } ], "expirationDate": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "role": string, "additionalRoles": [ string ], "inheritedFrom": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean }

JSON 表示法

{
  "id": string,
  "name": string,
  "type": string,
  "role": string,
  "additionalRoles": [
    string
  ],
  "authKey": string,
  "value": string,
  "kind": string,
  "withLink": boolean,
  "photoLink": string,
  "selfLink": string,
  "emailAddress": string,
  "domain": string,
  "etag": string,
  "permissionDetails": [
    {
      "permissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "expirationDate": string,
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean
}

欄位
`id`	`string` 這項權限參照的使用者 ID，與「關於」和「檔案」資源中的 `permissionId` 相同。建立 `drive.permissions.insert` 要求時，除非權限類型為 `anyone`，否則必須指定 `id` 或 `value` 其中之一。在這種情況下，系統會忽略 `id` 和 `value`。
`name`	`string` 僅供輸出。這項權限的名稱。
`type`	`string` 帳戶類型。允許的值包括： `user` `group` `domain` `anyone`
`role`	`string` 這位使用者的主要角色，我們日後可能會支援新的值，但目前允許下列值： `owner` `organizer` `fileOrganizer` `writer` `reader`
`additionalRoles[]`	`string` 這位使用者的其他角色。目前只支援 `commenter`，但日後可能會支援更多。
`authKey (deprecated)`	`string` 這個項目已遭淘汰！僅供輸出。已淘汰。
`value`	`string` 實體的電子郵件地址或網域名稱。這個資料庫會在插入作業時使用，且不會填入回應。建立 `drive.permissions.insert` 要求時，除非權限類型為 `anyone`，否則必須指定 `id` 或 `value` 其中之一。在這種情況下，系統會忽略 `id` 和 `value`。
`kind`	`string` 僅供輸出。一律為 `drive#permission`。
`withLink`	`boolean` 這項權限是否需要連結。
`photoLink`	`string` 僅供輸出。個人資料相片的連結 (如有)。
`selfLink`	`string` 僅供輸出。這項權限的連結。
`emailAddress`	`string` 僅供輸出。這個權限參照的使用者或群組電子郵件地址。這是僅供輸出的欄位，會在權限類型為 `user` 或 `group` 時顯示。
`domain`	`string` 僅供輸出。這項權限參照的實體網域名稱。這是僅供輸出的欄位，會在權限類型為 `user`、`group` 或 `domain` 時出現。
`etag`	`string` 僅供輸出。權限的 ETag。
`permissionDetails[]`	`object` 僅供輸出。詳細說明這個共用雲端硬碟項目的權限是沿用設定，還是直接套用至這個項目。這個僅輸出欄位，僅適用於共用雲端硬碟項目。
`permissionDetails[].permissionType`	`string` 僅供輸出。這位使用者的權限類型，雖然日後可能會加入新值，目前還有下列幾種： `file` `member`
`permissionDetails[].role`	`string` 僅供輸出。這位使用者的主要角色，雖然日後可能會加入新值，目前還有下列幾種： `organizer` `fileOrganizer` `writer` `reader`
`permissionDetails[].additionalRoles[]`	`string` 僅供輸出。這位使用者的其他角色。目前只支援 `commenter`，但日後可能會支援更多。
`permissionDetails[].inheritedFrom`	`string` 僅供輸出。繼承這項權限的項目 ID。這是一個僅限輸出的欄位。
`permissionDetails[].inherited`	`boolean` 僅供輸出。是否沿用這項權限。系統會一律在這個欄位填入資料。這是一個僅限輸出的欄位。
`expirationDate`	`string` 這項權限的效期 (RFC 3339 日期時間)。到期日具有以下限制：只能針對使用者和群組權限設定這類權限日期必須是未來的日期日期不得晚於未來一年
`teamDrivePermissionDetails[] (deprecated)`	`object` 這個項目已遭淘汰！僅供輸出。已淘汰：請改用 `permissionDetails`。
`teamDrivePermissionDetails[] (deprecated).teamDrivePermissionType (deprecated)`	`string` 僅供輸出。已淘汰：請改用 `permissionDetails/permissionType`。
`teamDrivePermissionDetails[] (deprecated).role (deprecated)`	`string` 僅供輸出。已淘汰：請改用 `permissionDetails/role`。
`teamDrivePermissionDetails[] (deprecated).additionalRoles[] (deprecated)`	`string` 僅供輸出。已淘汰：請改用 `permissionDetails/additionalRoles`。
`teamDrivePermissionDetails[] (deprecated).inheritedFrom (deprecated)`	`string` 僅供輸出。已淘汰：請改用 `permissionDetails/inheritedFrom`。
`teamDrivePermissionDetails[] (deprecated).inherited (deprecated)`	`boolean` 僅供輸出。已淘汰：請改用 `permissionDetails/inherited`。
`deleted`	`boolean` 僅供輸出。與這項權限相關聯的帳戶是否已刪除。這個欄位僅適用於使用者和群組權限。
`view`	`string` 指出這項權限的檢視畫面。只會針對屬於資料檢視的權限填入資料。`published` 是唯一支援的值。
`pendingOwner`	`boolean` 與這項權限連結的帳戶是否為待處理擁有者。僅針對非共用雲端硬碟中的檔案填入 `user` 類型權限。

方法
`delete`	從檔案或共用雲端硬碟刪除權限。
`get`	根據 ID 取得權限。
`getIdForEmail`	傳回電子郵件地址的權限 ID。
`insert`	插入檔案或共用雲端硬碟的權限。
`list`	列出檔案或共用雲端硬碟的權限。
`patch`	使用 patch 語意更新權限
`update`	更新權限。

REST Resource: permissions

資源：權限

方法

`delete`

`get`

`getIdForEmail`

`insert`

`list`

`patch`

`update`