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

排解經銷商 API 問題

本頁說明您在使用經銷商 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 呼叫次數。詳情請參閱「使用限制和配額」。