Method: users.insert

Tworzy użytkownika.

Wywołania mutacji bezpośrednio po utworzeniu użytkownika mogą czasami kończyć się niepowodzeniem, ponieważ użytkownik nie jest w pełni utworzony z powodu opóźnienia propagacji w naszych systemach backendu. Sprawdź szczegóły błędu w komunikacie „Tworzenie profilu użytkownika nie zostało zakończone”, aby dowiedzieć się, czy tak jest w Twoim przypadku. W takim przypadku może pomóc ponowienie połączeń po pewnym czasie.

Jeśli opcja resolveConflictAccount jest ustawiona na true, do rozwiązania problemu z kontami będącymi w konflikcie zostanie zastosowana opcja wybrana w sekcji Znajdowanie i dodawanie użytkowników niezarządzanych:

  • Kod odpowiedzi 200 oznacza, że użytkownik został utworzony (lub zastąpił istniejące niezarządzane konto osobiste).
  • Kod odpowiedzi 202 oznacza, że istnieje niezarządzane konto osobiste, które powoduje konflikt i zostało zaproszone do dołączenia do organizacji.
  • Kod odpowiedzi 409 oznacza, że istnieje konto w konflikcie, więc użytkownik nie został utworzony (np. na podstawie wybranej opcji zachowania konta lub jeśli adres e-mail jest w konflikcie z niezarządzanym kontem służbowym lub istniejącym zarządzanym użytkownikiem).

Szczegółowe informacje o rozwiązywaniu błędów związanych z duplikatami kont znajdziesz w artykułach Rozwiązywanie błędów związanych z duplikatami kont i Przenoszenie niezarządzanych kont służbowych.

Żą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: Stosuje opcję wybraną w przypadku ustawienia Znajdowanie i dodawanie użytkowników niezarządzanych, aby rozwiązywać konflikty kont, gdy jest ustawiona na true. Domyślnie: false

Treść żądania

Treść żądania zawiera wystąpienie elementu User.

Treść odpowiedzi

Jeśli operacja się uda, 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 po autoryzacji.