Method: users.insert

Erstellt einen Nutzer.

Mutate-Aufrufe, die unmittelbar nach der Nutzererstellung erfolgen, schlagen manchmal fehl, da der Nutzer aufgrund von Verzögerungen in unseren Backends noch nicht vollständig erstellt wurde. Prüfen Sie die Fehlerdetails für die Meldung „Nutzererstellung nicht abgeschlossen“, um festzustellen, ob dies der Fall ist. In diesem Fall kann es helfen, die Anrufe nach einiger Zeit noch einmal zu versuchen.

Wenn resolveConflictAccount auf true festgelegt ist, wird die für Nicht verwaltete Nutzer ermitteln und hinzufügen ausgewählte Option angewendet, um in Konflikt stehende Konten zu lösen:

  • Ein 200-Antwortcode gibt an, dass der Nutzer erstellt wurde (oder ein bestehendes nicht verwaltetes privates Konto ersetzt hat).
  • Der Antwortcode 202 bedeutet, dass ein in Konflikt stehendes, nicht verwaltetes privates Konto vorhanden ist und eingeladen wurde, der Organisation beizutreten.
  • Ein 409-Antwortcode bedeutet, dass ein in Konflikt stehendes Konto vorhanden ist und der Nutzer daher nicht erstellt wurde (z.B. basierend auf der ausgewählten Option zum Beibehalten des Kontos oder wenn die E-Mail-Adresse mit einem nicht verwalteten Arbeitskonto oder einem vorhandenen verwalteten Nutzer in Konflikt steht).

Weitere Informationen zum Beheben von Fehlern aufgrund doppelter Konten finden Sie unter Fehler aufgrund doppelter Konten beheben und Nicht verwaltete Arbeitskonten übertragen.

HTTP-Anfrage

POST https://admin.googleapis.com/admin/directory/v1/users

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
resolveConflictAccount

boolean

Optional. Wendet die für Nicht verwaltete Nutzer ermitteln und hinzufügen ausgewählte Option an, um in Konflikt stehende Konten zu beheben, wenn die Einstellung auf true festgelegt ist. Standardeinstellung: false

Anfragetext

Der Anfragetext enthält eine Instanz von User.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, 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 Autorisierungsleitfaden.