本頁將說明您可能遇到的 經銷商 API。
400:badRequest
如果訂閱項目遭到停權或取消,就會發生這項錯誤。適用對象 如需更多資訊,請參閱 啟用訂閱項目。
400:invalid
有許多原因都可能導致這個錯誤。
如果您使用 customers.insert
方法,請使用下列客戶
物件參數無效:
postalAddress.postalCode
無效。postalAddress.countryCode
不符合轉售 Google Workspace 的資格。alternateEmail
不能和customerDomain
位於相同的網域
如要解決這個問題,請確認必要參數存在且適用於 在調查期間
如果您使用 subscriptions.changeSeats
方法,請採取下列其中一種做法
問題也可能引發此錯誤:
- 您無法減少年約方案類型的帳戶名額。您可以考慮使用 變更續約設定。 以自動 (在續約時設定) 帳戶名額 帳戶活躍使用者人數
- 您指定的帳戶名額低於 讓他們使用服務帳戶傳送訊息給客戶,說明他們必須先移除使用者才能 減少他們的座位數。
- 您提高不正確的 seat 參數。針對「
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
參數繼續擷取所有訂閱項目
建立經銷商帳戶