Method: accessproposals.list
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
列出文件的访问权限提案。如需了解详情,请参阅管理待处理的访问权限提案。
注意:只有审批人才能列出文件的访问权限申请。如果用户不是审批者,则返回 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 )
访问提案列表。此字段仅在 Drive API v3 中填充。
|
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-09-09。
[null,null,["最后更新时间 (UTC):2025-09-09。"],[],[],null,["- [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 access proposals on a file. For more information, see [Manage pending access proposals](https://developers.google.com/workspace/drive/api/guides/pending-access).\n\nNote: Only approvers are able to list access proposals on a file. If the user isn't an approver, a 403 error is returned.\n\nHTTP 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\nPath parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------|\n| `fileId` | `string` Required. The ID of the item the request is on. |\n\nQuery 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\nRequest body\n\nThe request body must be empty.\n\nResponse body The 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 Drive API v3. |\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\nAuthorization 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)."]]