配額與限制

Content API for Shopping 對部分功能設有嚴格的配額與限制。 所有配額和限制都可能隨時刪除、縮減或變更,恕不另行通知。

配額政策

一天請勿更新產品超過兩次,也請勿每天更新子帳戶超過一次。

方法呼叫配額

Content API for Shopping 會根據用量自動調整 productsaccounts 配額。您的 accounts 用量是以子帳戶上限為準。

以下是我們追蹤配額用量的方式:

  • 配額為個別方法,舉例來說,get 方法與 update 方法有各自的配額。
  • patch 方法會計入您的 getupdate 配額。
  • custombatch 中的每個方法呼叫都會分別計入該方法的配額。
  • 呼叫會計入您驗證的帳戶配額,就像發出呼叫時一樣。舉例來說,如果您是以進階帳戶身分進行驗證,呼叫會計入進階帳戶的配額,但如果您是以其中一個子帳戶進行驗證,呼叫次數會計入子帳戶的配額。

查看配額

如要查看帳戶目前的配額和用量,請使用帳戶的 merchantId 呼叫 quotas.list

建議您定期檢查配額,確保自己有足夠的配額可供採用。

自動配額僅適用於 productsaccounts 服務。如果您需要提高任何其他服務的配額,已經達到 productsaccounts 服務的每日配額,或者您需要暫時提高 accounts 或產品 services 的配額,請與我們聯絡並提供下列資訊:

  • 您的 Merchant Center ID。
  • 您達到配額上限的方法為何。
  • 估算這些方法每天需要的呼叫次數。
  • 需要提高配額的原因。

錯誤

如果您超出 Content API for Shopping 配額,系統會顯示下列錯誤:

  • 每分鐘:quota/request_rate_too_high
  • 每天:quota/daily_limit_exceeded

如要查看配額和用量,以及要求增加每日或每分鐘的配額,請參閱檢查配額一節。

自動配額增加功能無法解決下列錯誤,您需要要求提高項目、動態饋給或子帳戶的配額

  • too_many_items: Merchant quota exceeded
  • too_many_subaccounts: Maximum number of sub-accounts reached

資源表示法限制

以下限制說明在 Content API 所使用資源表示法中,特定字串值和陣列欄位的特別限制。這些限制同樣適用於 Content API 以及 Merchant Center 中的相應功能。這份清單可能並不完整,也無法擴充這些限制。

資源 欄位 限制
shippingsettings

各國家/地區的運送服務 (services)。

每項運送服務 (rateGroups) 的運送群組數量。

每個運送群組的標籤 (applicableShippingLabels)。

每個運送群組的子表格 (subtables)。

單一費率表中的列數或欄數。

運送標籤的長度。

20

20

30

100

150

100

費率表中的列數或欄數會影響下列陣列欄位:

  • rowHeaderscolumnHeaders 中的陣列欄位:
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]