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

排解經銷商 API 問題

本頁說明使用 Reseller API 時可能遇到的一些常見問題。

`400:badRequest`

如果訂閱方案已暫停或取消，就會發生這項錯誤。詳情請參閱「啟用訂閱方案」。

造成這個錯誤的原因有很多，

如果您使用 customers.insert 方法，下列其中一個客戶物件參數無效：

如要解決這個問題，請確認必要參數存在，且對顧客有效。

如果您使用 subscriptions.changeSeats 方法，可能是下列其中一個問題導致這個錯誤：

年繳方案無法減少帳戶名額。建議變更續約設定。在續訂時，系統會自動將席位數設為帳戶中的活躍使用者人數。
您要求的帳戶名額少於帳戶目前的使用者人數。向顧客說明，他們必須先移除使用者，才能減少座位數。
你增加了錯誤的座位參數。如果是 FLEX 方案，請增加 maximumNumberOfSeats 參數；如果是 ANNUAL 方案，請增加 numberOfSeats 參數。
您嘗試變更 licensedNumberOfSeats 參數，但這是唯讀參數。
試用期間，客戶最多可使用 10 個名額。從免費試用訂閱方案改用付費服務，即可立即結束試用期、開始計費，並移除最多 10 個席位的限制。

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

當您達到這個 API 的每日呼叫配額時，就會發生這項錯誤。如要解決這個問題，請實作退避延遲。詳情請參閱使用限制和配額。

如果嘗試擷取大量訂閱項目，建議使用 subscriptions.list 方法，但不要指定 customerId 或 subscriptionId 參數。每次呼叫最多可傳回 100 項訂閱項目。使用 pageToken 參數，繼續擷取經銷商帳戶下的所有訂閱項目。

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

使用 customers.get 方法時，如果發生這個錯誤，表示任何 Google Workspace 帳戶都不存在該客戶或網域，且該網域可用。

這個錯誤是由多種不同問題所致。

如果使用 subscriptions.changeRenewalSettings 方法時發生這項錯誤，請確認您只在下列承諾付款方案中呼叫這個方法：

如果使用 subscriptions.delete 方法時發生這項錯誤，表示 Google Workspace 帳戶沒有管理員使用者。如要解決這個問題，請新增臨時管理員使用者，然後再試一次。

如果在 subscriptions.insert 方法中遇到這個錯誤，表示您無法將所選 SKU 轉售給新興市場客戶，如要解決這個問題，請接受適用的服務條款。

如果超過每秒查詢次數上限，就會發生這個錯誤。如要解決這個問題，請實作退避重試策略或快取結果，減少 API 呼叫次數。詳情請參閱使用限制和配額。