本頁說明您在以經銷商的身分使用 Directory API 時可能遇到的一些常見問題。
400:badRequest
當將不正確的參數值傳遞至方法時,就會發生這個錯誤。
如果您使用 users.get
方法,請確認傳遞至 userKey
參數的值是使用者的主要電子郵件地址、別名電子郵件地址或不重複使用者 ID。
如果您使用 users.list
方法,請確認下列參數:
customer
參數:僅使用 Google 產生的customerId
。請勿使用實際客戶的網域。我們建議您使用這個參數,因為如果客戶擁有次要網域,使用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
方法建立臨時管理員使用者,然後繼續在最終網域驗證步驟中佈建帳戶。 - 驗證網域時,請將臨時使用者新增至
webResource.insert
呼叫要求主體的owners[]
參數。撥打這通電話,直到收到200
回應。 - 網域通過驗證後,請使用
users.patch
或users.update
方法重新命名臨時使用者名稱。
- 使用
如果您無法驗證客戶的網域,請按照下列步驟操作:
- 使用
users.insert
方法建立臨時管理員使用者。 - 請客戶以臨時使用者身分登入,並透過管理控制台驗證網域。
- 網域通過驗證後,客戶或您可以重新命名臨時使用者名稱。您可以使用
users.patch
或users.update
方法。
- 使用
412:limitExceeded
如果客戶的帳戶名額已達上限,就會出現這個錯誤。如要解決這個問題,請使用 subscriptions.changeSeats
方法,並視其訂閱方案而定,使用下列方法:
- 如果是
FLEXIBLE
,請增加maximumNumberOfSeats
參數。 - 如果是
ANNUAL
,請增加numberOfSeats
參數。