カタログ

カタログバッチAPI

このガイドでは、カタログバッチAPIの使用方法について説明します。

  • Advantage+ カタログ広告のカタログ - インベントリーが急激に変化する数百万のアイテムを含むカタログのような、大きなカタログがある場合はこのAPIを使用します。1つのHTTPリクエストで複数のアイテムを作成、更新、削除できます。

  • コマースカタログ - 1時間に1回以上の頻度で商品情報を更新する必要がある場合に、このAPIを使用します(そうでない場合はフィードAPIを使用します)。1つのHTTPリクエストで複数のアイテムを更新できます。

しくみ

インベントリーが急激に変化する数百万のアイテムを含むカタログのような大きなカタログがある場合は、カタログバッチAPIを使用します。1つのHTTPリクエストで複数のアイテムを作成、更新、削除できます。

カタログバッチAPIは、次のエンドポイントで構成されています。

エンドポイント 説明 このガイドの該当個所

POST/{catalog_id}/items_batch

カタログのリクエスト(作成、更新、削除)のバッチを送信します。商品、ホテル、ホテルの部屋、フライト、目的地、物件リスティング、自動車、自動車クーポンなど、さまざまなオブジェクトに使用されます。

3.2までのすべてのMAPIバージョンをサポートします。

商品アップデートの送信

GET/{catalog_id}/check_batch_request_status

バッチリクエストのステータスを確認します。ハンドル({catalog_id}/batchへの呼び出しによって返されたもの)を使用し、GET呼び出しを実行します。

3.1より前のすべてのMAPIバージョンをサポートします。

バッチリクエストステータスの確認

POST/{catalog_id}/localized_items_batch

カタログ内の既存のカタログアイテムに、バッチローカリゼーションリクエストを送信します。バッチには(作成、アップデート、削除の)ローカリゼーションリクエストを含めることができます。このエンドポイントは、商品、ホテル、フライト、目的地、物件リスティング、自動車など、さまざまなオブジェクトに使用できます。

3.1より前のすべてのMAPIバージョンをサポートします。

ローカライズされたアイテムバッチの送信

次のステップ

カタログバッチAPIガイドを参考にして、カタログバッチAPIで一般的なアクションを実行します。

詳しくはこちら