REST Resource: users.settings.delegates
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Recurso: delegação
Configurações de um delegado. Os delegados podem ler, enviar e excluir mensagens, além de acessar e adicionar contatos na conta do delegante. Consulte "Configurar a delegação de e-mails" para mais informações sobre delegados.
| Representação JSON |
{
"delegateEmail": string,
"verificationStatus": enum (VerificationStatus)
} |
| Campos |
delegateEmail |
string
O endereço de e-mail do delegado.
|
verificationStatus |
enum (VerificationStatus)
Indica se o endereço foi verificado e pode atuar como um delegado da conta. Somente leitura.
|
VerificationStatus
Indica se a propriedade de um endereço de e-mail foi verificada para uso de delegação.
| Enums |
verificationStatusUnspecified |
Status de verificação não especificado. |
accepted |
O endereço pode atuar como delegado da conta. |
pending |
Uma solicitação de verificação foi enviada por correio para o endereço, e o proprietário ainda não a aceitou. |
rejected |
Uma solicitação de verificação foi enviada por correio para o endereço, e o proprietário a rejeitou. |
expired |
Uma solicitação de verificação foi enviada por correio para o endereço e expirou sem ser verificada. |
Métodos |
|
|
Adiciona um delegado com o status de verificação definido diretamente como accepted, sem enviar nenhum e-mail de verificação. |
|
|
Remove o delegado especificado (que pode ter qualquer status de verificação) e revoga qualquer verificação que tenha sido necessária para usá-lo. |
|
|
Recebe o delegado especificado. |
|
|
Lista os delegados da conta especificada. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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. |"]]
