REST Resource: users.settings.delegates
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ressource: Delegate
Paramètres d'un délégué. Les délégués peuvent lire, envoyer et supprimer des messages, ainsi que consulter et ajouter des contacts pour le compte du délégant. Pour en savoir plus sur les délégués, consultez Configurer la délégation de messagerie.
| Représentation JSON |
{
"delegateEmail": string,
"verificationStatus": enum (VerificationStatus)
} |
| Champs |
delegateEmail |
string
Adresse e-mail du délégué.
|
verificationStatus |
enum (VerificationStatus)
Indique si cette adresse a été validée et peut servir de délégué pour le compte. Lecture seule.
|
VerificationStatus
Indique si la propriété d'une adresse e-mail a été validée pour une utilisation en délégation.
| Enums |
verificationStatusUnspecified |
État de validation non spécifié. |
accepted |
L'adresse peut servir de délégué pour le compte. |
pending |
Une demande de validation a été envoyée par courrier à l'adresse indiquée, et le propriétaire ne l'a pas encore acceptée. |
rejected |
Une demande de validation a été envoyée par courrier à l'adresse indiquée, et le propriétaire l'a refusée. |
expired |
Une demande de validation a été envoyée par courrier à l'adresse, et elle a expiré sans avoir été validée. |
Méthodes |
|
|
Ajoute un délégué dont l'état de validation est défini directement sur accepted, sans envoyer d'e-mail de validation. |
|
|
Supprime le délégué spécifié (qui peut avoir n'importe quel état de validation) et révoque toute validation qui aurait pu être requise pour l'utiliser. |
|
|
Récupère le délégué spécifié. |
|
|
Liste les délégués du compte spécifié. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]
