排解 Directory API 問題

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

如要解決這個問題，請按照下列步驟操作：

  1. 呼叫 users.get 方法。

    如果收到 200 回應，表示客戶的 Google Workspace 帳戶中已有該使用者。您無法在帳戶中新增這位使用者，

    如果收到 403 forbidden 回應，表示主要電子郵件地址中的網域不是經銷商客戶，或是主要電子郵件地址先前用於其他 Google 產品，且客戶的網域必須先通過驗證，才能順利新增。

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

    1. 使用 users.insert 方法建立臨時管理員使用者，然後繼續在最終網域驗證步驟中佈建帳戶。
    2. 驗證網域時，請將臨時使用者新增至 webResource.insert 呼叫要求主體的 owners[] 參數。撥打這通電話，直到收到 200 回應。
    3. 網域通過驗證後，請使用 users.patch 或 users.update 方法重新命名臨時使用者名稱。

  3. 如果您無法驗證客戶的網域，請按照下列步驟操作：

    1. 使用 users.insert 方法建立臨時管理員使用者。
    2. 請客戶以臨時使用者身分登入，並透過管理控制台驗證網域。
    3. 網域通過驗證後，客戶或您可以重新命名臨時使用者名稱。您可以使用 users.patch 或 users.update 方法。

412:limitExceeded

如果客戶的帳戶名額已達上限，就會出現這個錯誤。如要解決這個問題，請使用 subscriptions.changeSeats 方法，並視其訂閱方案而定，使用下列方法：

  • 如果是 FLEXIBLE，請增加 maximumNumberOfSeats 參數。
  • 如果是 ANNUAL，請增加 numberOfSeats 參數。