Method: users.insert

建立使用者。

在使用者建立程序完成前,立即呼叫 Mutate 可能會失敗,因為後端的傳播延遲可能導致使用者尚未完全建立。請檢查「未完成使用者建立程序」錯誤訊息的詳細資料,確認是否為此問題。在這種情況下,稍後重試呼叫可能有助於解決問題。

如果 resolveConflictAccount 設為 true202 回應代碼表示有相衝突的非受管帳戶,且已受邀加入機構。409 回應碼表示存在相衝突的帳戶,因此系統並未根據所選的處理非受管使用者帳戶選項建立使用者。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
resolveConflictAccount

boolean

選用設定。如果設為 true,系統就會套用處理非受管使用者帳戶時所選的選項。預設值:false

要求主體

要求主體包含 User 的例項。

回應主體

如果成功,回應主體會包含新建立的 User 例項。

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱授權指南