列出檔案的存取權提議。詳情請參閱「管理待處理的存取權提案」。
注意:只有核准者才能列出檔案的存取提案。如果使用者不是核准者,系統會傳回 403 錯誤。
HTTP 要求
GET https://www.googleapis.com/drive/v3/files/{fileId}/accessproposals
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
fileId |
必要欄位。要求所屬項目的 ID。 |
查詢參數
參數 | |
---|---|
pageToken |
(選用步驟) 存取要求清單中的接續符記。 |
pageSize |
(選用步驟) 每頁的結果數。 |
要求主體
要求主體必須為空白。
回應主體
存取提案清單要求的相關回應。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
---|
{
"accessProposals": [
{
object ( |
欄位 | |
---|---|
accessProposals[] |
存取提案清單。這個欄位只會在 Drive API v3 中填入。 |
nextPageToken |
下一頁結果的接續符記。如果已到達結果清單的結尾,就不會顯示這個值。如果系統基於任何原因拒絕符記,就應捨棄該符記,並從第一頁結果重新開始分頁。 |
授權範圍
需要下列其中一種 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
部分範圍受到限制,應用程式必須通過安全性評估才能使用。詳情請參閱授權指南。