本頁將說明您可能遇到的 以經銷商身分使用 Directory API。
400:badRequest
如果傳遞至方法的參數值有誤,就會發生這項錯誤。
如果使用 users.get
方法,請確認傳遞至 userKey
的值
參數是使用者的主要電子郵件地址、別名電子郵件地址或
不重複的使用者 ID
如果您使用 users.list
方法,請確認下列參數:
customer
參數:僅使用由customerId
Google。請勿使用實際客戶的網域。建議做法 參數,因為如果客戶擁有次要網域,使用domain
參數只會傳回電子郵件地址位於該特定網域的使用者。domain
參數:只使用實際客戶的網域。請勿使用
由 Google 產生的customerId
。
403:domainCannotUseApis
當您的客戶停用了經銷商對 Admin SDK API。如要解決這個問題,請要求客戶重新啟用以下存取權: Admin SDK API若需更多資訊,請參閲 控管 API 存取權。
如果要查看目前授權的使用者人數,而得出
發生錯誤,請使用 licensedNumberOfSeats
欄位,而不要呼叫 users.list
方法
從訂閱資源中移除
403:forbidden
這個錯誤是因為您並非客戶的擁有者,或您的客戶遭到停用 。
如要解決這個問題,請呼叫
customers.get
方法
再撥打電話來驗證客戶的經銷商擁有權,或請
客戶即可重新啟用經銷商的管理控制台存取權。如要
資訊,請參閱
存取客戶的管理控制台。
403:usageLimits.accessNotConfigured
如果 Google Cloud 專案未啟用這個 API,就會發生這個錯誤。解決方法 請前往 Google Cloud 控制台啟用 API。如要 資訊,請參閱 啟用 Google Workspace API。
409:duplicate
當您嘗試新增使用者,但客戶的 下列其中一個地址已有相同的主要電子郵件:
- 您要將這類帳戶新增到目前的 Google Workspace 帳戶。
- 其他 Google 產品 (非 Google Workspace)。
請按照下列步驟解決這個問題:
呼叫
users.get
方法。如果收到
200
回應,就表示客戶已存在於客戶的 Google Workspace 帳戶。您無法在帳戶中加入這位使用者。如果收到
403 forbidden
回應,請填入主要網域 電子郵件參數並非經銷商客戶,或已經使用主要電子郵件地址 先前用於其他 Google 產品,而且客戶的網域必須 ,才能順利新增此使用者。如果您能驗證客戶的網域,請按照下列步驟操作:
- 使用以下角色建立臨時管理員使用者:
users.insert
方法 ,然後繼續完成最後的網域驗證步驟。 - 驗證網域時,請將臨時使用者新增至
owners[]
參數的內文參數webResource.insert
呼叫。 撥打這通電話,直到收到200
回應為止。 - 網域通過驗證後,請使用
或
users.patch
敬上 或users.update
方法。
- 使用以下角色建立臨時管理員使用者:
如果您無法驗證客戶的網域,請按照下列步驟操作:
- 使用以下角色建立臨時管理員使用者:
users.insert
方法。 - 請客戶以臨時使用者身分登入並驗證 網域。
- 驗證網域後,客戶或您
這個臨時使用者名稱。您可以使用
users.patch
敬上 或users.update
方法。
- 使用以下角色建立臨時管理員使用者:
412:limitExceeded
當您的客戶達到帳戶名額上限時,就會發生這個錯誤。目的地:
解決這個問題,請使用 subscriptions.changeSeats
方法
根據使用者的訂閱方案,使用下列版本:
- 如果是
FLEXIBLE
,請提高maximumNumberOfSeats
參數。 - 如果是
ANNUAL
,請提高numberOfSeats
參數。