Method: users.insert
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Erstellt einen Nutzer.
Mutate-Aufrufe direkt nach der Nutzererstellung können manchmal fehlschlagen, da der Nutzer aufgrund einer Verzögerung bei der Weiterleitung in unseren Backends nicht vollständig erstellt wurde. Prüfen Sie in den Fehlerdetails, ob die Meldung „Nutzererstellung ist nicht abgeschlossen“ angezeigt wird. In diesem Fall kann es helfen, die Aufrufe nach einiger Zeit noch einmal zu versuchen.
Wenn resolveConflictAccount auf true gesetzt ist, bedeutet ein Antwortcode 202, dass ein in Konflikt stehendes nicht verwaltetes Konto vorhanden ist und zur Teilnahme an der Organisation eingeladen wurde. Ein Antwortcode vom Typ 409 bedeutet, dass ein in Konflikt stehendes Konto vorhanden ist. Der Nutzer wurde daher nicht gemäß der ausgewählten Option für die Verwaltung nicht verwalteter Nutzerkonten erstellt.
HTTP-Anfrage
POST https://admin.googleapis.com/admin/directory/v1/users
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
| Parameter |
resolveConflictAccount |
boolean
Optional. Wenn true festgelegt ist, wird die für die Verwaltung nicht verwalteter Nutzerkonten ausgewählte Option angewendet. Standardeinstellung: false
|
Anfragetext
Der Anfragetext enthält eine Instanz von User.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von User.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/admin.directory.user
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.insert\n\nCreates a user.\n\nMutate calls immediately following user creation might sometimes fail as the user isn't fully created due to propagation delay in our backends. Check the error details for the \"User creation is not complete\" message to see if this is the case. Retrying the calls after some time can help in this case.\n\nIf `resolveConflictAccount` is set to `true`, a `202` response code means that a conflicting unmanaged account exists and was invited to join the organization. A `409` response code means that a conflicting account exists so the user wasn't created based on the [handling unmanaged user accounts](https://support.google.com/a/answer/11112794) option selected.\n\n### HTTP request\n\n`POST https://admin.googleapis.com/admin/directory/v1/users`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `resolveConflictAccount` | `boolean` Optional. If set to `true`, the option selected for [handling unmanaged user accounts](https://support.google.com/a/answer/11112794) will apply. Default: `false` |\n\n### Request body\n\nThe request body contains an instance of [User](/workspace/admin/directory/reference/rest/v1/users#User).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [User](/workspace/admin/directory/reference/rest/v1/users#User).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/admin.directory.user`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
