配額與限制

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

配額政策

每天請勿更新產品超過 2 次,而且每天不要更新子帳戶超過一次。

方法呼叫配額

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