割り当てと上限

Content API for Shopping では、一部の機能に厳格な割り当てと制限が課されています。 すべての割り当てと上限は、予告なく解除、削減、変更される場合があります。

割り当てポリシー

商品の更新頻度は 1 日 2 回まで、サブアカウントの更新回数は 1 日 1 回までにしてください。

メソッド呼び出しの割り当て

Content API for Shopping では、productsaccounts の割り当ては使用量に基づいて自動的に調整されます。accounts の使用量は、サブアカウントの上限に基づきます。

割り当ての使用状況を追跡する方法は次のとおりです。

  • 割り当てはメソッド単位です。たとえば、get メソッドには update メソッドとは別の割り当てがあります。
  • patch メソッドは、getupdate の両方の割り当てに対してカウントされます。
  • custombatch 内の各メソッド呼び出しは、そのメソッドの割り当てに対して個別にカウントされます。
  • 呼び出しは、呼び出し時に認証するアカウントの割り当てにカウントされます。たとえば、アドバンス アカウントとして認証する場合、呼び出しはアドバンス アカウントの割り当てにカウントされますが、サブアカウントの 1 つとして認証すると、呼び出しはサブアカウントの割り当てにカウントされます。

割り当てを確認する

アカウントの現在の割り当てと使用状況を確認するには、アカウントの merchantId を指定して quotas.list を呼び出します。

割り当てを定期的に確認して、実装に対する十分な割り当てを確保することをおすすめします。

自動割り当ては、products サービスと accounts サービスにのみ適用されます。他のサービスの割り当ての引き上げが必要な場合、products サービスまたは accounts サービスの 1 日あたりの割り当ての上限に達している場合、または accounts またはサービス services の一時的な引き上げが必要な場合は、以下の情報をお問い合わせください。

  • Merchant Center ID です。
  • 割り当て上限に達したメソッド。
  • これらのメソッドで 1 日あたりに必要な呼び出し数の見積もり。
  • 割り当ての増加が必要な理由。

エラー

Content API for Shopping の割り当てを超えると、次のエラーが発生します。

  • 1 分あたり: quota/request_rate_too_high
  • 1 日あたり: quota/daily_limit_exceeded

割り当てと使用状況を表示し、1 日あたりまたは 1 分あたりの割り当ての増加をリクエストするには、割り当てを確認するをご覧ください。

以下のエラーは割り当ての自動増量では解決できないため、アイテム、フィード、サブアカウントの追加割り当てをリクエストする必要があります。

  • 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

1 つの送料テーブル内の行数または列数。

配送ラベルの長さ。

20

20

30

100

150

100

送料テーブルの行数または列数は、以下の配列フィールドに影響します。

  • rowHeaders または columnHeaders 内の配列フィールド:
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]