Method: users.insert
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Tworzy użytkownika.
Wywołania metody Mutate bezpośrednio po utworzeniu użytkownika mogą czasami kończyć się niepowodzeniem, ponieważ użytkownik nie został w pełni utworzony z powodu opóźnienia propagacji w naszych backendach. Aby się o tym przekonać, sprawdź szczegóły błędu „Tworzenie profilu użytkownika nie zostało zakończone”. W takim przypadku możesz spróbować ponownie zadzwonić po pewnym czasie.
Jeśli wartość resolveConflictAccount to true, kod odpowiedzi 202 oznacza, że istnieje konto niezarządzane, które jest sprzeczne z kontem organizacji i zostało zaproszone do dołączenia do niej. Kod odpowiedzi 409 oznacza, że istnieje konto będące w konflikcie, więc użytkownik nie został utworzony na podstawie wybranej opcji obsługi kont użytkowników niezarządzanych.
Żądanie HTTP
POST https://admin.googleapis.com/admin/directory/v1/users
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
| Parametry |
resolveConflictAccount |
boolean
Opcjonalnie: Jeśli ustawisz wartość true, zostanie zastosowana opcja wybrana w sekcji Zarządzanie kontami użytkowników niezarządzanych. Wartość domyślna: false
|
Treść żądania
Treść żądania zawiera wystąpienie elementu User.
Treść odpowiedzi
Jeśli operacja się powiedzie, treść odpowiedzi będzie zawierała nowo utworzoną instancję User.
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/admin.directory.user
Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 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)."]]
