排解 Directory API 問題

本頁將說明您可能遇到的 以經銷商身分使用 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)。

請按照下列步驟解決這個問題:

  1. 呼叫 users.get 方法。

    如果收到 200 回應,就表示客戶已存在於客戶的 Google Workspace 帳戶。您無法在帳戶中加入這位使用者。

    如果收到 403 forbidden 回應,請填入主要網域 電子郵件參數並非經銷商客戶,或已經使用主要電子郵件地址 先前用於其他 Google 產品,而且客戶的網域必須 ,才能順利新增此使用者。

  2. 如果您能驗證客戶的網域,請按照下列步驟操作:

    1. 使用以下角色建立臨時管理員使用者: users.insert 方法 ,然後繼續完成最後的網域驗證步驟。
    2. 驗證網域時,請將臨時使用者新增至 owners[] 參數的內文參數 webResource.insert 呼叫。 撥打這通電話,直到收到 200 回應為止。
    3. 網域通過驗證後,請使用 或 users.patch敬上 或 users.update 方法。
  3. 如果您無法驗證客戶的網域,請按照下列步驟操作:

    1. 使用以下角色建立臨時管理員使用者: users.insert 方法
    2. 請客戶以臨時使用者身分登入並驗證 網域。
    3. 驗證網域後,客戶或您 這個臨時使用者名稱。您可以使用 users.patch敬上 或 users.update 方法。

412:limitExceeded

當您的客戶達到帳戶名額上限時,就會發生這個錯誤。目的地: 解決這個問題,請使用 subscriptions.changeSeats 方法 根據使用者的訂閱方案,使用下列版本:

  • 如果是 FLEXIBLE,請提高 maximumNumberOfSeats 參數。
  • 如果是 ANNUAL,請提高 numberOfSeats 參數。