本頁面由 Cloud Translation API 翻譯而成。

排解 Directory API 問題

本頁面說明您在擔任經銷商時，可能會遇到的 Directory API 相關常見問題。

`400:badRequest`

當方法收到錯誤的參數值時，就會發生此錯誤。

如果使用 users.get 方法，請確認傳遞至 userKey 參數的值是使用者的主電子郵件地址、別名電子郵件地址或專屬使用者 ID。

如果使用 users.list 方法，請驗證下列參數：

customer 參數：請僅使用 Google 產生的 customerId。請勿使用實際客戶的網域。我們建議使用這個參數，因為如果客戶有次要網域，使用 domain 參數只會傳回該特定網域中電子郵件地址的使用者。
domain 參數：僅使用實際客戶的網域。請勿使用 Google 產生的
customerId。

如果客戶已停用經銷商對 Admin SDK API 的存取權，就會發生這項錯誤。如要解決這個問題，請要求客戶重新啟用 Admin SDK API 存取權。詳情請參閱「控管 API 存取權」。

如果您嘗試取得目前授權使用者的數量，但卻收到此錯誤，請改為使用訂閱資源中的 licensedNumberOfSeats 欄位，而非呼叫 users.list 方法。

如果您不是客戶的擁有者，或是客戶已停用經銷商的管理控制台存取權，就會發生這個錯誤。

如要解決這個問題，請先呼叫 customers.get 方法，再呼叫驗證客戶經銷商擁有權的函式，或是請客戶重新啟用管理控制台的經銷商存取權。詳情請參閱「存取客戶的管理控制台」。

如果 Google Cloud 專案中未啟用 API，就會發生這個錯誤。如要解決這個問題，請前往 Google Cloud 控制台並啟用 API。詳情請參閱「啟用 Google Workspace API」。

當您嘗試新增使用者，但客戶的主要電子郵件地址已存在於下列任一項目時，就會發生此錯誤：

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

呼叫 users.get 方法。

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

如果您收到 403 forbidden 回應，表示主要電子郵件參數中的網域不是轉售客戶，或是主要電子郵件先前已用於其他 Google 產品，因此必須先驗證客戶的網域，才能成功新增此使用者。
如果您可以驗證客戶的網域，請按照下列步驟操作：
1. 使用 users.insert 方法建立臨時管理員使用者，然後繼續進行最終的網域驗證步驟。
2. 驗證網域時，請將臨時使用者新增至 webResource.insert 呼叫要求主體的 owners[] 參數中。請持續呼叫，直到收到 200 回應為止。
3. 網域驗證完成後，請使用 users.patch 或 users.update 方法重新命名臨時使用者名稱。
如果無法驗證客戶的網域，請執行下列操作：
1. 使用 users.insert 方法建立臨時管理員使用者。
2. 請客戶以臨時使用者的身分登入，並透過管理控制台驗證其網域。
3. 網域驗證完成後，客戶或您可以重新命名臨時使用者名稱。您可以使用 users.patch 或 users.update 方法。

當客戶已達到座位數量上限時，就會發生這個錯誤。如要解決這個問題，請使用 subscriptions.changeSeats 方法，並根據會員的訂閱方案使用下列方法：