Method: users.settings.sendAs.create
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Crée un alias d'expéditeur personnalisé. Si un MSA SMTP est spécifié, Gmail tente de se connecter au service SMTP pour valider la configuration avant de créer l'alias. Si la validation de la propriété de l'alias est requise, un message est envoyé à l'adresse e-mail et l'état de validation de la ressource est défini sur pending. Sinon, la ressource est créée avec un état de validation défini sur accepted. Si une signature est fournie, Gmail nettoie le code HTML avant de l'enregistrer avec l'alias.
Cette méthode n'est disponible que pour les clients de comptes de service auxquels une autorité au niveau du domaine a été déléguée.
Requête HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/sendAs
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 "me" permet d'indiquer l'utilisateur authentifié.
|
Corps de la requête
Le corps de la requête contient une instance de SendAs.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de SendAs.
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 d'autorisation.
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,["# Method: users.settings.sendAs.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nCreates a custom \"from\" send-as alias. If an SMTP MSA is specified, Gmail will attempt to connect to the SMTP service to validate the configuration before creating the alias. If ownership verification is required for the alias, a message will be sent to the email address and the resource's verification status will be set to `pending`; otherwise, the resource will be created with verification status set to `accepted`. If a signature is provided, Gmail will sanitize the HTML before saving it with the alias.\n\nThis method is only available to service account clients that have been delegated domain-wide authority.\n\n### HTTP request\n\n`POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/sendAs`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------|\n| `userId` | `string` User's email address. The special value \"me\" can be used to indicate the authenticated user. |\n\n### Request body\n\nThe request body contains an instance of [SendAs](/workspace/gmail/api/reference/rest/v1/users.settings.sendAs#SendAs).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [SendAs](/workspace/gmail/api/reference/rest/v1/users.settings.sendAs#SendAs).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/gmail.settings.sharing`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
