本頁說明您可能遇到的 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
方法,不要指定 customerId
或 subscriptionId
參數。每次呼叫最多可傳回 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
方法,不要指定 customerId
或 subscriptionId
參數。每次呼叫最多可傳回 100 個訂閱項目。使用 pageToken
參數繼續擷取經銷商帳戶下的所有訂閱。