REST Resource: accessproposals
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
資源:AccessProposal
檔案上未處理的存取權提議的 Access Proposal 資源
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 標準化,並使用 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
要求者建議的角色。日後可能會新增值,但目前可能的值如下:* writer * commenter * reader
|
view |
string
指出這項存取提案的檢視畫面。只有屬於檢視區塊的提案才會填入資料。目前唯一支援的值是 published 。
|
方法 |
|
依 ID 擷取 AccessProposal。 |
|
列出檔案的 AccessProposal。 |
|
用於核准或拒絕存取提案。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-27 (世界標準時間)。
[null,null,["上次更新時間:2025-08-27 (世界標準時間)。"],[],[],null,["# REST Resource: accessproposals\n\n- [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\n------------------------\n\nThe Access Proposal resource for 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. |\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 uses 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\n-----------\n\nA wrapper for the role and view of an access proposal.\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 New values may be added in the future, but the following are currently possible: \\* `writer` \\* `commenter` \\* `reader` |\n| `view` | `string` Indicates the view for this access proposal. Only populated for proposals that belong to a view. `published` is the only supported value. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------------|---------------------------------------------|\n| ### [get](/workspace/drive/api/reference/rest/v3/accessproposals/get) | Retrieves an AccessProposal by ID. |\n| ### [list](/workspace/drive/api/reference/rest/v3/accessproposals/list) | List the AccessProposals on a file. |\n| ### [resolve](/workspace/drive/api/reference/rest/v3/accessproposals/resolve) | Used to approve or deny an Access Proposal. |"]]