配額與限制

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[]