割り当てと上限

Merchant API の機能には厳格な割り当てと上限が適用されます。

ポリシーの更新

Merchant API では、更新に関して次のポリシーが適用されます。

• 商品を更新できるのは 1 日に 2 回までです。
• サブアカウントを更新できるのは 1 日に 1 回のみです。

Merchant API と Content API for Shopping の割り当て関連の変更

• 割り当てはメソッドごとではなく、リソースごとにカウントされます。一部のサービスがリンクされたことを意味します。
• カスタム バッチ処理がない場合でも、割り当ての計算には影響しません。たとえば、500 件の挿入リクエストを含むバッチ リクエストは、500 件の個別の挿入メソッド リクエストとして課金されます。
• アカウントとプロダクトの割り当ての自動化は引き続き行われます。
• 自動化とオーバーライドを含む現在の割り当ての使用量と上限を確認するには、Quota.list メソッドを使用します。

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

Merchant API は、使用量に基づいて products と accounts の呼び出し割り当てを自動的に調整します。

割り当て使用量の追跡方法は次のとおりです。

• 割り当てはメソッドごとです。たとえば、get メソッドには update メソッドとは別の割り当てがあります。
• リクエストの種類にかかわらず、各リクエストは 1 回カウントされます。たとえば、250 個のアイテムの list リクエストは 1 回カウントされ、250 個の get リクエストとしてカウントされません。
• 割り当ては、API リクエストを行ったユーザーに基づいて課金されます。ユーザーが上級アカウントの直接メンバーである場合、割り当ては上級アカウントのレベルで課金されます。
• 割り当ては、呼び出し時に認証を行う Comparison Shopping Service（CSS）グループ、CSS、アカウント、サブアカウントに適用されます。たとえば、上級者向けアカウントとして認証した場合、呼び出しは上級者向けアカウントの割り当てに対してカウントされますが、サブアカウントのいずれかとして認証した場合、呼び出しはサブアカウントの割り当てに対してカウントされます。

この図は、CSS グループ、CSS、アカウント、サブアカウントの階層を示しています。

割り当てを確認する

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

自動割り当ては、products サービスと accounts サービスにのみ適用されます。他のサービスの割り当ての増加が必要な場合、products サービスまたは accounts サービスの 1 日あたりの割り当てに達している場合、または accounts またはプロダクト services の一時的な増加が必要な場合は、以下の情報を添えて Google にお問い合わせください。

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

実装に十分な割り当てがあることを確認するため、または割り当てが自動的に調整される仕組みを確認するため、割り当てを定期的に確認することをおすすめします。

エラー

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

• 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

リソース表現の上限

次の上限は、Merchant API で使用されるリソース表現内の特定の文字列値と配列フィールドに関する重要な制限事項を示しています。これらの上限は、Merchant API と Merchant Center の対応する機能に共通しています。

この上限のリストは網羅的なものではありません。この上限は延長されません。

リソース	フィールド	上限
shippingsettings	国あたりの配送サービス数（services）。 配送サービスあたりの配送グループ数（rateGroups）。 配送グループあたりのラベル数（applicableShippingLabels）。 配送グループあたりのサブテーブル数（subtables）。 1 つの料金表内の行数または列数。 送料ラベルの長さ。	20 20 30 100 150 100

料金表の行数または列数は、次の配列フィールドに影響します。

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