Method: files.accessproposals.list

列出檔案中的 AccessProposals。注意：只有核准者才能在檔案中列出存取權提案。如果使用者不是核准者，則會傳回 403。

HTTP 要求

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

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

路徑參數

參數
fileId

string

必要欄位。要求涉及的項目 ID。

查詢參數

參數
pageToken

string

選用設定。存取要求清單上的接續權杖。
pageSize

integer

選用設定。每頁結果數

要求主體

要求主體必須為空白。

回應主體

存取提案清單要求的回應。

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

JSON 表示法 
{
  "accessProposals": [
    {
      object (AccessProposal)
    }
  ],
  "nextPageToken": string
}
欄位
accessProposals[]

object (AccessProposal)

存取權提案清單。這個欄位只會在 v3 和 v3beta 版中填入。
nextPageToken

string

下一頁結果的接續符記。如果已達到結果清單的結尾，就不會顯示這個引數。如果符記因任何原因遭到拒絕，則應將其捨棄，並從第一頁結果重新開始分頁。

授權範圍

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

  • https://www.googleapis.com/auth/docs
  • 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.readonly

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

AccessProposal

尚未解決檔案的存取提案資源

JSON 表示法 
{
  "fileId": string,
  "proposalId": string,
  "requesterEmailAddress": string,
  "recipientEmailAddress": string,
  "rolesAndViews": [
    {
      object (RoleAndView)
    }
  ],
  "requestMessage": string,
  "createTime": string
}
欄位
fileId

string

存取提案的檔案 ID
proposalId

string

存取提案的 ID
requesterEmailAddress

string

提出要求的使用者電子郵件地址
recipientEmailAddress

string

權限選取的使用者電子郵件地址
rolesAndViews[]

object (RoleAndView)

存取提案的角色和檢視畫面的包裝函式。
requestMessage

string

要求者在提案中新增的訊息
createTime

string (Timestamp format)

建立時間

RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

RoleAndView

一個角色及存取權提案檢視畫面的包裝函式。

JSON 表示法 
{
  "role": string,
  "view": string
}
欄位
role

string

要求者提議的角色未來可能會新增下列值：* writer * commenter * reader
view

string

表示此存取權提案的檢視畫面。只會針對屬於資料檢視的提案填入資料。published 是唯一支援的值。