REST Resource: users.settings.delegates
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Recurso: Delegado
Configuración de un delegado. Los delegados pueden leer, enviar y borrar mensajes, así como ver y agregar contactos, de la cuenta del delegante. Consulta "Cómo configurar la delegación de correo" para obtener más información sobre los delegados.
| Representación JSON |
{
"delegateEmail": string,
"verificationStatus": enum (VerificationStatus)
} |
| Campos |
delegateEmail |
string
Es la dirección de correo electrónico del delegado.
|
verificationStatus |
enum (VerificationStatus)
Indica si esta dirección se verificó y puede actuar como delegado de la cuenta. Solo lectura.
|
VerificationStatus
Indica si se verificó la propiedad de una dirección de correo electrónico para su uso de delegación.
| Enumeraciones |
verificationStatusUnspecified |
Estado de verificación sin especificar. |
accepted |
La dirección puede actuar como delegado de la cuenta. |
pending |
Se envió una solicitud de verificación por correo a la dirección, y el propietario aún no la acepta. |
rejected |
Se envió una solicitud de verificación por correo a la dirección, y el propietario la rechazó. |
expired |
Se envió una solicitud de verificación por correo a la dirección y venció sin que se completara. |
Métodos |
|
|
Agrega un delegado con su estado de verificación establecido directamente en accepted, sin enviar ningún correo electrónico de verificación. |
|
|
Quita el delegado especificado (que puede tener cualquier estado de verificación) y revoca cualquier verificación que se haya requerido para usarlo. |
|
|
Obtiene el delegado especificado. |
|
|
Muestra una lista de los delegados de la cuenta especificada. |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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. |"]]
