Method: users.insert

建立使用者。

在建立使用者後立即發出的變動呼叫有時可能會失敗,因為使用者尚未完全建立,後端傳播作業有延遲。請檢查「未完成使用者建立程序」訊息的錯誤詳細資料,確認是否為這種情況。在這種情況下,過一段時間後重試呼叫即可解決問題。

如果 resolveConflictAccount 設為 true,系統會套用為「尋找及新增非受管使用者」選取的選項,解決相衝突的帳戶問題:

  • 200 回應代碼表示使用者已建立 (或取代現有的非受管理個人帳戶)。
  • 202 回應代碼表示存在衝突的非受管理個人帳戶,且該帳戶已受邀加入機構。
  • 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

詳情請參閱授權指南