REST Resource: users.settings.delegates
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Ресурс: Делегат
Настройки делегата. Представители могут читать, отправлять и удалять сообщения, а также просматривать и добавлять контакты для учетной записи делегатора. Дополнительные сведения о делегатах см. в разделе «Настройка делегирования почты» .
| JSON-представление |
|---|
{
"delegateEmail": string,
"verificationStatus": enum (VerificationStatus)
} |
| Поля |
|---|
delegateEmail | string Адрес электронной почты делегата. |
verificationStatus | enum ( VerificationStatus ) Указывает, проверен ли этот адрес и может ли он выступать в качестве делегата учетной записи. Только для чтения. |
Статус проверки
Указывает, было ли подтверждено право собственности на адрес электронной почты для использования при делегировании.
| Перечисления |
|---|
verificationStatusUnspecified | Неопределенный статус проверки. |
accepted | Адрес может выступать делегатом учетной записи. |
pending | На адрес был отправлен запрос на проверку, но владелец еще не принял его. |
rejected | На этот адрес был отправлен запрос на проверку, но владелец отклонил его. |
expired | Запрос на проверку был отправлен по почте на адрес, и срок его действия истек без проверки. |
Методы |
|---|
| Добавляет делегата со статусом проверки, установленным непосредственно на accepted , без отправки электронного письма с подтверждением. |
| Удаляет указанный делегат (который может иметь любой статус проверки) и отменяет любую проверку, которая могла потребоваться для его использования. |
| Получает указанный делегат. |
| Перечисляет делегатов для указанной учетной записи. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 2025-07-25 UTC."],[],[],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. |"]]
