REST Resource: users.settings.delegates
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
资源:委托
受托人的设置。受托人可以代委托人查看、发送和删除邮件,以及查看和添加联系人。如需详细了解受托人,请参阅“设置邮件委托”。
字段 |
delegateEmail |
string
受托人的电子邮件地址。
|
verificationStatus |
enum (VerificationStatus )
指明此地址是否已通过验证,以及是否可以充当该账号的受托人。只读。
|
VerificationStatus
指示电子邮件地址的所有权是否已通过验证,以便用于委托。
枚举 |
verificationStatusUnspecified |
未指定验证状态。 |
accepted |
该地址可以充当该账号的受托人。 |
pending |
验证请求已邮寄至该地址,但所有者尚未接受。 |
rejected |
我们已通过邮件将验证请求发送至该地址,但所有者拒绝了该请求。 |
expired |
我们已将验证请求寄送至该地址,但该请求已过期且未经验证。 |
方法 |
|
添加验证状态直接设为 accepted 的受托人,而不会发送任何验证电子邮件。 |
|
移除指定的受托人(其验证状态可以是任何状态),并撤消使用该受托人可能需要完成的所有验证。 |
|
获取指定的代理。 |
|
列出指定账号的受托人。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):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. |"]]