排解經銷商 API 問題

本頁說明您可能遇到的 Reseller API 相關問題。

400:badRequest

如果訂閱遭停權或取消,就會出現這個錯誤。詳情請參閱「啟用訂閱項目」一文。

400:invalid

有許多原因可能會造成這個錯誤。

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

  • postalAddress.postalCode」無效。
  • postalAddress.countryCode」不符合轉售 Google Workspace 的資格。
  • alternateEmail 不得與 customerDomain 位於相同網域

如要解決這個問題,請確認有必要參數且能夠為客戶有效。

如果您使用 subscriptions.changeSeats 方法,就可能會發生這個錯誤:

  • 您無法為年繳方案類型減少帳戶名額。建議您變更續約設定。,讓訂閱項目自動設定 (續約時) 的帳戶名額等於帳戶中的活躍使用者人數。
  • 您申請的帳戶名額少於該帳戶目前的使用者人數。訊息客戶必須移除使用者,才能減少帳戶名額。
  • 您增加了錯誤的座位參數。如果是 FLEX 方案,請增加 maximumNumberOfSeats 參數,然後針對 ANNUAL 方案增加 numberOfSeats 參數。
  • 您嘗試變更 licensedNumberOfSeats 參數,這是唯讀參數。
  • 在試用期間,客戶的帳戶名額上限是 10 個。 從免費試用訂閱方案開始啟用付費服務,讓試用期立即結束、開始計費,並移除 10 個帳戶名額上限。

403:forbidden

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

403:usageLimits.dailyLimitExceeded

當您達到每日對這個 API 的呼叫配額時,就會發生這個錯誤。要解決這個問題,請實作輪詢延遲時間。詳情請參閱「用量限制與配額」一文。

如果您嘗試擷取多個訂閱項目,請考慮使用 subscriptions.list 方法,不要指定 customerIdsubscriptionId 參數。每次呼叫最多可傳回 100 個訂閱項目。使用 pageToken 參數繼續擷取經銷商帳戶下的所有訂閱。

403:usageLimits.accessNotConfigured

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

404:notFound

使用 customers.get 方法時,這個錯誤代表沒有任何 Google Workspace 帳戶該客戶或網域,且網域可供使用。

412:conditionNotMet

這項錯誤是因幾個不同問題所造成。

如果在使用 subscriptions.changeRenewalSettings 方法時遇到這個錯誤,請確認您只針對下列承諾使用付款方案呼叫這個方法:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

如果您在使用 subscriptions.delete 方法時遇到這個錯誤,表示 Google Workspace 帳戶中沒有任何管理員使用者。如要解決這個問題,請新增臨時的管理員使用者,然後再試一次。

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

429:usageLimits.quotaExceeded

當您超出每秒的查詢數量上限時,就會發生這項錯誤。如要解決這個問題,請實作輪詢重試策略或快取結果,以減少 API 呼叫。詳情請參閱「用量限制與配額」一文。

如果您嘗試擷取多個訂閱項目,請考慮使用 subscriptions.list 方法,不要指定 customerIdsubscriptionId 參數。每次呼叫最多可傳回 100 個訂閱項目。使用 pageToken 參數繼續擷取經銷商帳戶下的所有訂閱。