排解經銷商 API 問題

本頁將說明您可能遇到的 經銷商 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 方法,但並未指定 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 參數繼續擷取所有訂閱項目 建立經銷商帳戶