Method: permissions.list

列出檔案或共用雲端硬碟的權限。

HTTP 要求

GET https://www.googleapis.com/drive/v3/files/{fileId}/permissions

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
fileId

string

檔案或共用雲端硬碟的 ID。

查詢參數

參數
pageSize

integer

每個頁面傳回的權限數量上限。如果未設定在共用雲端硬碟中的檔案，系統會傳回最多 100 筆結果。如未設定要存放在共用雲端硬碟中的檔案，系統會傳回整份清單。
pageToken

string

接續下一頁要求清單要求的下一頁。這個值必須設為先前回應的「nextPageToken」值。
supportsAllDrives

boolean

提出要求的應用程式是否支援「我的雲端硬碟」和共用雲端硬碟。
supportsTeamDrives
(deprecated)

boolean

已淘汰：請改用 supportsAllDrives。
useDomainAdminAccess

boolean

以網域管理員的身分發出要求；如果設為 true，要求者將取得檔案存取權，前提是檔案 ID 參數參照共用雲端硬碟，且要求者是該共用雲端硬碟所屬網域的管理員。
includePermissionsForView

string

指定要在回應中包含哪些額外檢視畫面的權限。僅支援「已發布」。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體即會包含具有以下結構的資料：

檔案的權限清單。

JSON 表示法 
{
  "nextPageToken": string,
  "kind": string,
  "permissions": [
    {
      object (Permission)
    }
  ]
}
欄位
nextPageToken

string

下一頁的權限頁面權杖。如未達到權限清單的結尾，就不會顯示這個欄位。如果符記因任何原因而遭拒，則應捨棄該分頁，而且分頁開頭必須重新分頁。
kind

string

識別這是哪種資源類型。值：固定字串 "drive#permissionList"。
permissions[]

object (Permission)

權限清單如果填入 NextPageToken，此清單可能不完整，並應擷取額外的結果頁面。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

部分範圍會受到限制，而且需要應用程式接受安全性評估才能使用這些範圍。詳情請參閱授權指南。