Method: users.insert

Crée un utilisateur.

Les appels de mutation immédiatement après la création d'un utilisateur peuvent parfois échouer, car l'utilisateur n'est pas entièrement créé en raison du délai de propagation dans nos backends. Consultez les détails de l'erreur "La création de l'utilisateur n'est pas terminée" pour vérifier si c'est le cas. Dans ce cas, il peut être utile de réessayer les appels après un certain temps.

Si resolveConflictAccount est défini sur true, l'option sélectionnée pour Rechercher et ajouter des utilisateurs non gérés s'appliquera pour résoudre les conflits de comptes :

  • Un code de réponse 200 indique que l'utilisateur a été créé (ou qu'il a remplacé un compte personnel non géré existant).
  • Un code de réponse 202 signifie qu'un compte personnel non géré en conflit existe et a été invité à rejoindre l'organisation.
  • Un code de réponse 409 signifie qu'un compte en conflit existe et que l'utilisateur n'a pas été créé (par exemple, en fonction de l'option sélectionnée pour conserver le compte, ou si l'adresse e-mail est en conflit avec un compte professionnel non géré ou un utilisateur géré existant).

Pour savoir comment résoudre les erreurs de compte en double, consultez Résoudre les erreurs de compte en double et Transférer des comptes professionnels non gérés.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
resolveConflictAccount

boolean

Facultatif. Applique l'option sélectionnée pour Rechercher et ajouter des utilisateurs non gérés afin de résoudre les problèmes de comptes en conflit lorsque le paramètre est défini sur true. Par défaut, false.

Corps de la requête

Le corps de la requête contient une instance de User.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de User.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/admin.directory.user

Pour en savoir plus, consultez le guide d'autorisation.