列出檔案的存取權提議。詳情請參閱「管理待處理的存取權提案」。
注意:只有核准者才能列出檔案的存取提案。如果使用者不是核准者,系統會傳回 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/docshttps://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/drive.metadatahttps://www.googleapis.com/auth/drive.metadata.readonlyhttps://www.googleapis.com/auth/drive.readonly
部分範圍受到限制,應用程式必須通過安全性評估才能使用。詳情請參閱授權指南。