Method: users.insert
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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. Pour savoir si c'est le cas, vérifiez les détails de l'erreur du message "La création de l'utilisateur n'est pas terminée". Dans ce cas, réessayer les appels après un certain temps peut aider.
Si resolveConflictAccount est défini sur true, un code de réponse 202 signifie qu'un compte 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. L'utilisateur n'a donc pas été créé en fonction de l'option Gérer les comptes utilisateur non gérés sélectionnée.
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. Si la valeur est true, l'option sélectionnée pour la gestion des comptes utilisateur non gérés s'applique. 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.
Champs d'application 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.
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.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)."]]
