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
某些镜重受限,您的应用需要接受安全评估才能使用它们。如需了解详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):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)."]]