Method: users.insert

ユーザーを作成します。

ユーザーの作成直後のミューテーション呼び出しは、バックエンドの伝播遅延によりユーザーが完全に作成されていないため、失敗することがあります。「ユーザーの作成が完了していません」というメッセージのエラーの詳細を確認して、このケースに該当するかどうかを確認します。このような場合は、しばらくしてから呼び出しを再試行すると解決することがあります。

resolveConflictAccount が true に設定されている場合、競合するアカウントを解決するために、[管理対象外ユーザーを見つけて追加する] で選択したオプションが適用されます。

  • 200 レスポンス コードは、ユーザーが作成された（または既存の管理対象外の個人アカウントが置き換えられた）ことを示します。
  • 202 レスポンス コードは、競合する管理されていない個人用アカウントが存在し、組織への参加が招待されたことを意味します。
  • 409 レスポンス コードは、競合するアカウントが存在するため、ユーザーが作成されなかったことを意味します（アカウントを保持するために選択されたオプションに基づく場合や、メールアドレスが管理対象外の仕事用アカウントまたは既存の管理対象ユーザーと競合する場合など）。

アカウントの重複エラーを解決する方法について詳しくは、アカウントの重複エラーを解決すると管理対象外の仕事用アカウントを移行するをご覧ください。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

クエリ パラメータ

パラメータ
resolveConflictAccount

boolean

省略可。true に設定されている場合、管理対象外ユーザーを見つけて追加するで選択したオプションを適用して、競合するアカウントを解決します。デフォルト: false

リクエストの本文

リクエストの本文には User のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には、新しく作成された User のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

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

詳しくは、承認ガイドをご覧ください。