割り当てと上限

販売者アカウントと Merchant API の使用には、割り当てと上限が適用されます。

ポリシーの更新

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

• 商品を更新できるのは 1 日に 2 回までです。1 分あたりの割り当てに準拠するため、1 日の呼び出しを 1 日を通して均等に分散する必要があります。
• サブアカウントを更新できるのは 1 日に 1 回のみです。注: 1 日あたりの呼び出し割り当ては通常、販売者が保有する商品割り当ての 2 倍に設定されます。これは、1 つの商品に対する更新に厳密に関連するものではありません。

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

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

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

• 割り当てはメソッドごとです。たとえば、get メソッドには update メソッドとは別の割り当てがあります。
• リクエストの種類にかかわらず、リクエストごとに 1 回カウントされます。たとえば、250 個のアイテムの list リクエストは、250 個の get リクエストとしてではなく、1 回としてカウントされます。
• 割り当ては、API リクエストを行うユーザーに基づいて課金されます。ユーザーが高度なアカウントの直接メンバーである場合、割り当ては高度なアカウントのレベルで課金されます。
• 割り当ては、呼び出しを行うときに認証するショッピング比較サービス（CSS）グループ、CSS、アカウント、またはサブアカウントに適用されます。たとえば、高度なアカウントとして認証すると、呼び出しは高度なアカウントの割り当てに対してカウントされますが、サブアカウントの 1 つとして認証すると、呼び出しはサブアカウントの割り当てに対してカウントされます。

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

Content API for Shopping のメソッド呼び出しの割り当ての変更

Content API for Shopping を使用していた場合は、Merchant API でのメソッド呼び出しの割り当ての変更について、次の点に注意してください。

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

呼び出しの割り当てを確認する

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

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

• 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

アカウントの制限

accounts.limits.get メソッドと accounts.limits.list メソッドを使用すると、アカウント レベルのエンティティの制限を確認できます。これらの方法を使用して、プロダクトの上限を確認できます。

特定の商品の上限を取得するには（アカウントの広告の EEA 割り当てを取得するなど）、accounts.limits.get への呼び出しでアカウント ID と上限 ID を指定する必要があります。上限 ID は、上限タイプとスコープの組み合わせです。たとえば、EEA で広告をターゲットに設定している商品には products~ADS_EEA、EEA 以外で広告をターゲットに設定している商品には products~ADS_NON_EEA を使用します。

特定のアカウントの products~ADS_EEA 上限を取得するリクエストの例を次に示します。

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits/products~ADS_EEA

アカウントで使用可能な上限 ID を確認するには、type="products" のフィルタを使用して accounts.limits.list を使用します。

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits?filter=type%3D%22products%22

商品の割り当てについて詳しくは、Google Merchant Center 内の各種割り当てについてをご覧ください。

リソース表現の上限

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

この上限のリストは網羅的なものではありません。これらの上限を引き上げることはできません。

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

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