配額與限制

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