REST Resource: users.settings.delegates
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
資源:委派
委派函的設定。委派代表可以讀取、傳送及刪除委派者帳戶的郵件,以及查看及新增聯絡人。如要進一步瞭解委派,請參閱「設定郵件委派」一文。
欄位 |
delegateEmail |
string
代表的電子郵件地址。
|
verificationStatus |
enum (VerificationStatus )
指出這個地址是否已驗證,且能否擔任帳戶的代理人。唯讀。
|
VerificationStatus
指出電子郵件地址的擁有權是否已驗證,以便委派使用。
列舉 |
verificationStatusUnspecified |
未指定驗證狀態。 |
accepted |
這個地址可做為帳戶的委派代表。 |
pending |
驗證要求已透過郵件寄送至該地址,但擁有者尚未接受。 |
rejected |
我們已將驗證要求寄到該地址,但擁有者拒絕接受。 |
expired |
驗證要求已寄到指定地址,但未經過驗證就過期。 |
方法 |
|
新增委派帳戶,並直接將驗證狀態設為 accepted ,不需傳送任何驗證電子郵件。 |
|
移除指定的代理人 (可為任何驗證狀態),並撤銷使用該代理人時可能需要的任何驗證。 |
|
取得指定的委派函。 |
|
列出指定帳戶的委派代表。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[],[],null,["# REST Resource: users.settings.delegates\n\n- [Resource: Delegate](#Delegate)\n - [JSON representation](#Delegate.SCHEMA_REPRESENTATION)\n- [VerificationStatus](#VerificationStatus)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Delegate\n------------------\n\nSettings for a delegate. Delegates can read, send, and delete messages, as well as view and add contacts, for the delegator's account. See [\"Set up mail delegation\"](https://support.google.com/mail/answer/138350) for more information about delegates.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"delegateEmail\": string, \"verificationStatus\": enum (/workspace/gmail/api/reference/rest/v1/users.settings.delegates#VerificationStatus) } ``` |\n\n| Fields ||\n|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `delegateEmail` | `string` The email address of the delegate. |\n| `verificationStatus` | `enum (`[VerificationStatus](/workspace/gmail/api/reference/rest/v1/users.settings.delegates#VerificationStatus)`)` Indicates whether this address has been verified and can act as a delegate for the account. Read-only. |\n\nVerificationStatus\n------------------\n\nIndicates whether ownership of an email address has been verified for delegation use.\n\n| Enums ||\n|---------------------------------|------------------------------------------------------------------------------------------|\n| `verificationStatusUnspecified` | Unspecified verification status. |\n| `accepted` | The address can act a delegate for the account. |\n| `pending` | A verification request was mailed to the address, and the owner has not yet accepted it. |\n| `rejected` | A verification request was mailed to the address, and the owner rejected it. |\n| `expired` | A verification request was mailed to the address, and it expired without verification. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### [create](/workspace/gmail/api/reference/rest/v1/users.settings.delegates/create) | Adds a delegate with its verification status set directly to `accepted`, without sending any verification email. |\n| ### [delete](/workspace/gmail/api/reference/rest/v1/users.settings.delegates/delete) | Removes the specified delegate (which can be of any verification status), and revokes any verification that may have been required for using it. |\n| ### [get](/workspace/gmail/api/reference/rest/v1/users.settings.delegates/get) | Gets the specified delegate. |\n| ### [list](/workspace/gmail/api/reference/rest/v1/users.settings.delegates/list) | Lists the delegates for the specified account. |"]]