割り当てと上限

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

ポリシーの更新

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

  • 商品を更新できるのは 1 日に 2 回までです。1 分あたりの割り当てに準拠するため、1 日の呼び出しを 1 日を通して均等に分散する必要があります。
  • サブアカウントを更新できるのは 1 日に 1 回のみです。

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

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

割り当ての使用状況は次のように追跡されます。

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

この図は、CSS グループ、CSS、アカウント、サブアカウントの階層を示しています。 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 を指定する必要があります。accounts.limits.get上限 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 を確認するには、 accounts.limits.list を使用して、type="products" のフィルタを使用します。

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 の対応する機能に共通しています。

なお、この上限のリストはすべてを網羅しているわけではありません。これらの上限を引き上げることはできません。

リソース フィールド 上限
shippingsettings

国あたりの配送サービス数（services）。

配送サービスあたりの配送グループ数（rateGroups）。

配送グループあたりのラベル数（applicableShippingLabels）。

配送グループあたりのサブテーブル数（subtables）。

1 つの 料金表 内の行数または列数。

送料ラベルの長さ。

20

20

30

100

150

100

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

  • rowHeaders または columnHeaders 内の配列フィールド:
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]
前へ
Manage conversion sources
次へ
Track usage metrics