Method: users.insert

建立使用者。

在使用者建立後立即變更呼叫的做法,有時可能會失敗,因為後端的更新作業有所延遲,導致系統沒有完整建立使用者。查看「建立使用者未完成」訊息的錯誤詳細資料,看看是否發生這種情形。在這種情況下,請於一段時間後重試通話。

如果將 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

詳情請參閱授權指南