REST Resource: users.settings.delegates
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Risorsa: Delegate
Impostazioni per un delegato. I delegati possono leggere, inviare ed eliminare messaggi, nonché visualizzare e aggiungere contatti, per l'account del delegante. Per ulteriori informazioni sui delegati, consulta "Configurare la delega email".
| Rappresentazione JSON |
{
"delegateEmail": string,
"verificationStatus": enum (VerificationStatus)
} |
| Campi |
delegateEmail |
string
L'indirizzo email del delegato.
|
verificationStatus |
enum (VerificationStatus)
Indica se questo indirizzo è stato verificato e può agire come delegato per l'account. Sola lettura.
|
VerificationStatus
Indica se la proprietà di un indirizzo email è stata verificata per l'utilizzo della delega.
| Enum |
verificationStatusUnspecified |
Stato di verifica non specificato. |
accepted |
L'indirizzo può fungere da delegato per l'account. |
pending |
È stata inviata una richiesta di verifica all'indirizzo e il proprietario non l'ha ancora accettata. |
rejected |
Una richiesta di verifica è stata inviata all'indirizzo e il proprietario l'ha rifiutata. |
expired |
Una richiesta di verifica è stata inviata all'indirizzo e scaduta senza essere stata verificata. |
Metodi |
|
|
Aggiunge un delegato con lo stato di verifica impostato direttamente su accepted, senza inviare alcuna email di verifica. |
|
|
Rimuove il delegato specificato (che può avere qualsiasi stato di verifica) e revoca qualsiasi verifica che potrebbe essere stata richiesta per utilizzarlo. |
|
|
Recupera il delegato specificato. |
|
|
Elenca i delegati per l'account specificato. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]
