Method: users.insert

ユーザーを作成する。

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

resolveConflictAccount が true に設定されている場合、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

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