排解 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 參數。