REST Resource: accessproposals
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
资源:AccessProposal
JSON 表示法 |
{
"fileId": string,
"proposalId": string,
"requesterEmailAddress": string,
"recipientEmailAddress": string,
"rolesAndViews": [
{
object (RoleAndView )
}
],
"requestMessage": string,
"createTime": string
} |
字段 |
fileId |
string
包含访问权限提案的文件 ID。
|
proposalId |
string
访问提案的 ID。
|
requesterEmailAddress |
string
提出请求的用户的电子邮件地址。
|
recipientEmailAddress |
string
将接收权限的用户的电子邮件地址(如果接受)。
|
rolesAndViews[] |
object (RoleAndView )
访问提案的角色和视图的封装容器。如需了解详情,请参阅角色和权限。
|
requestMessage |
string
请求者添加到提案中的消息。
|
createTime |
string (Timestamp format)
创建时间。 采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z" 、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30" 。
|
RoleAndView
访问提案的角色和视图的封装容器。如需了解详情,请参阅角色和权限。
JSON 表示法 |
{
"role": string,
"view": string
} |
字段 |
role |
string
请求者提议的角色。支持的值如下:
|
view |
string
指明相应访问提案的视图。仅针对属于视图的提案进行填充。仅支持 published 。
|
方法 |
|
根据 ID 检索访问提案。 |
|
列出文件的访问权限提案。 |
|
批准或拒绝访问权限提案。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-09-09。
[null,null,["最后更新时间 (UTC):2025-09-09。"],[],[],null,["- [Resource: AccessProposal](#AccessProposal)\n - [JSON representation](#AccessProposal.SCHEMA_REPRESENTATION)\n- [RoleAndView](#RoleAndView)\n - [JSON representation](#RoleAndView.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: AccessProposal Manage outstanding access proposals on a file.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"fileId\": string, \"proposalId\": string, \"requesterEmailAddress\": string, \"recipientEmailAddress\": string, \"rolesAndViews\": [ { object (/workspace/drive/api/reference/rest/v3/accessproposals#RoleAndView) } ], \"requestMessage\": string, \"createTime\": string } ``` |\n\n| Fields ||\n|-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `fileId` | `string` The file ID that the proposal for access is on. |\n| `proposalId` | `string` The ID of the access proposal. |\n| `requesterEmailAddress` | `string` The email address of the requesting user. |\n| `recipientEmailAddress` | `string` The email address of the user that will receive permissions, if accepted. |\n| `rolesAndViews[]` | `object (`[RoleAndView](/workspace/drive/api/reference/rest/v3/accessproposals#RoleAndView)`)` A wrapper for the role and view of an access proposal. For more information, see [Roles and permissions](https://developers.google.com/workspace/drive/api/guides/ref-roles). |\n| `requestMessage` | `string` The message that the requester added to the proposal. |\n| `createTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` The creation time. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n\nRoleAndView A wrapper for the role and view of an access proposal. For more information, see [Roles and permissions](https://developers.google.com/workspace/drive/api/guides/ref-roles).\n\n| JSON representation |\n|--------------------------------------------|\n| ``` { \"role\": string, \"view\": string } ``` |\n\n| Fields ||\n|--------|------------------------------------------------------------------------------------------------------------------------------------------|\n| `role` | `string` The role that was proposed by the requester. The supported values are: - `writer` - `commenter` - `reader` |\n| `view` | `string` Indicates the view for this access proposal. Only populated for proposals that belong to a view. Only `published` is supported. |\n\n| Methods ||\n|---------------------------------------------------------------------------|----------------------------------------|\n| [get](/workspace/drive/api/reference/rest/v3/accessproposals/get) | Retrieves an access proposal by ID. |\n| [list](/workspace/drive/api/reference/rest/v3/accessproposals/list) | List the access proposals on a file. |\n| [resolve](/workspace/drive/api/reference/rest/v3/accessproposals/resolve) | Approves or denies an access proposal. |"]]