Method: users.insert
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Cria um usuário.
Às vezes, as chamadas Mutate imediatamente após a criação do usuário podem falhar porque o usuário não foi totalmente criado devido ao atraso na propagação nos nossos back-ends. Verifique os detalhes do erro na mensagem "A criação do usuário não foi concluída" para saber se esse é o caso. Nesse caso, tente fazer as chamadas novamente depois de algum tempo.
Se resolveConflictAccount estiver definido como true, um código de resposta 202 significa que uma conta não gerenciada conflitante existe e foi convidada para participar da organização. Um código de resposta 409 significa que existe uma conta conflitante. Portanto, o usuário não foi criado com base na opção gerenciar contas de usuário não gerenciadas selecionada.
Solicitação HTTP
POST https://admin.googleapis.com/admin/directory/v1/users
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de consulta
| Parâmetros |
resolveConflictAccount |
boolean
Opcional. Se definido como true, a opção selecionada para gerenciar contas de usuário não gerenciadas será aplicada. Padrão: false
|
Corpo da solicitação
O corpo da solicitação contém uma instância de User.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de User.
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/admin.directory.user
Para mais informações, consulte o guia de autorização.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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)."]]
