Method: accessproposals.list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
列出檔案中的 AccessProposals。注意:只有核准者才能在檔案中列出 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
部分權限受限制,應用程式必須通過安全性評估才能使用。詳情請參閱授權指南。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[],[],null,["# Method: accessproposals.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListAccessProposalsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nList the AccessProposals on a file. Note: Only approvers are able to list AccessProposals on a file. If the user is not an approver, returns a 403.\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v3/files/{fileId}/accessproposals`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------|\n| `fileId` | `string` Required. The id of the item the request is on. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------|\n| `pageToken` | `string` Optional. The continuation token on the list of access requests. |\n| `pageSize` | `integer` Optional. The number of results per page |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe response to an Access Proposal list request.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"accessProposals\": [ { object (/workspace/drive/api/reference/rest/v3/accessproposals#AccessProposal) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `accessProposals[]` | `object (`[AccessProposal](/workspace/drive/api/reference/rest/v3/accessproposals#AccessProposal)`)` The list of Access Proposals. This field is only populated in v3 and v3beta. |\n| `nextPageToken` | `string` The continuation token for the next page of results. This will be absent if the end of the results list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/docs`\n- `\n https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.metadata`\n- `\n https://www.googleapis.com/auth/drive.metadata.readonly`\n- `\n https://www.googleapis.com/auth/drive.readonly`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]