Method: users.aliases.insert
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Fügen Sie einen Alias hinzu.
HTTP-Anfrage
POST https://admin.googleapis.com/admin/directory/v1/users/{userKey}/aliases
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
userKey |
string
Identifiziert den Nutzer in der API-Anfrage. Der Wert kann die primäre E-Mail-Adresse, die Alias-E-Mail-Adresse oder die eindeutige Nutzer-ID des Nutzers sein.
|
Anfragetext
Der Anfragetext enthält eine Instanz von UserAlias.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von UserAlias.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://apps-apis.google.com/a/feeds/alias/
https://www.googleapis.com/auth/admin.directory.user
https://www.googleapis.com/auth/admin.directory.user.alias
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[],[],null,["# Method: users.aliases.insert\n\nAdds an alias.\n\n### HTTP request\n\n`POST https://admin.googleapis.com/admin/directory/v1/users/{userKey}/aliases`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|---------------------------------------------------------------------------------------------------------------------------------------------|\n| `userKey` | `string` Identifies the user in the API request. The value can be the user's primary email address, alias email address, or unique user ID. |\n\n### Request body\n\nThe request body contains an instance of [UserAlias](/workspace/admin/directory/reference/rest/v1/users.aliases#UserAlias).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [UserAlias](/workspace/admin/directory/reference/rest/v1/users.aliases#UserAlias).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://apps-apis.google.com/a/feeds/alias/`\n- `\n https://www.googleapis.com/auth/admin.directory.user`\n- `\n https://www.googleapis.com/auth/admin.directory.user.alias`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
