Method: users.settings.forwardingAddresses.create
Crée une adresse de transfert. Si la validation de la propriété est requise, un message est envoyé au destinataire, et l'état de validation de la ressource est défini sur pending. Sinon, la ressource est créée avec l'état de validation accepted.
Cette méthode n'est disponible que pour les clients de compte de service qui disposent d'une autorité déléguée au niveau du domaine.
Requête HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/forwardingAddresses
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
userId |
string
Adresse e-mail de l'utilisateur. La valeur spéciale "moi" peut être utilisée pour indiquer l'utilisateur authentifié.
|
Corps de la requête
Le corps de la requête contient une instance ForwardingAddress.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de ForwardingAddress.
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/gmail.settings.sharing
Pour en savoir plus, consultez le guide relatif aux autorisations.
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 2024/09/05 (UTC).
[null,null,["Dernière mise à jour le 2024/09/05 (UTC)."],[[["Creates a forwarding address for a Gmail user, requiring domain-wide delegated authority for service accounts."],["If ownership verification is needed, a verification message is sent, setting the status to `pending`; otherwise, the status is set to `accepted`."],["Uses the `POST` method and provides details on the request body, response body, path parameters, and required authorization scope."],["This feature utilizes the `https://www.googleapis.com/auth/gmail.settings.sharing` OAuth scope for access and management of forwarding addresses."]]],["A forwarding address is created using a `POST` request to the specified URL, including the user's email in the `userId` path parameter. The request body must contain a `ForwardingAddress` instance. Ownership verification might be initiated, setting the status to `pending`. The operation is limited to service accounts with domain-wide authority, requiring the `gmail.settings.sharing` OAuth scope. Successful creation returns a new `ForwardingAddress` instance in the response body.\n"]]
