メインコンテンツへスキップ

​
概要

Catalog API は、広告主が商品フィードを設定し、商品をセットにまとめ、カタログ内の商品を包括的に管理できるコマース向けソリューションです。Catalog API はプログラムによるカタログ管理を可能にする中核ツールであり、カタログの取り込みや更新方法に対して広告主により高いコントロールを提供します。 カタログには、ユーザーの商品および商品セットに関するすべての情報が保持され、ユーザーのハンドルに関連付けられます。現在、1 人のユーザーが作成できるカタログは 1 つのみです。  Catalog API は、商品取り込みの方法として次の 2 種類をサポートします:
  1. Scheduled Feed: ユーザーはフィードの URL（CSV、TSV、XML）を追加でき、定期的に取得されます（X では現在最大 8GB のファイルに対応）
  2. Batch Products API: ユーザーはバッチ（JSON）リクエストで商品属性の閲覧、作成、更新、delete が可能
X のマーチャントは、フィルタールールに基づいて商品セットを作成できます。これにより、商品に追加の metadata を付与し、オーガニックコマース機能や動的商品広告を通じてこれらの商品を紹介する特別な商品セットを作成できます。Catalog API と X Shopping Manager は 2 種類の商品セットをサポートしています。 
  1. Manual: ユーザーは最大 50 点の商品を選択し、名前と説明を設定できます
  2. Filter: ユーザーは最大 30 個のフィルターを追加して、条件を満たす商品でセットを自動生成できます。フィルターの種類には、価格、Google 商品カテゴリ、商品タイプ、在庫、セール価格、カスタム fields などが含まれます。
Catalog API には、カタログを管理するための 4 つの endpoint が用意されています:
  • Product Catalogs - 商品情報のコンテナを作成
  • Products -  カタログ内商品の同期的な追加、更新、閲覧、削除
  • Product Sets -  商品情報に基づいて商品をグループ化
  • Schedule Feeds - ファイルベースの商品データをカタログに非同期で取り込む設定

​
Catalog API の前提条件

Catalog API のendpointは現在、早期アクセスでのみ提供されています。アクセス申請は、X の担当者までご連絡ください。 X Shopping Manager を通じて利用規約に同意する必要があります。 Shopping Manager と製品仕様の詳細については、Product specifications guide を参照してください。

​
レートリミット 

以下の表に、各endpointのレートリミットを示します。

​
Product Catalog

HTTP メソッドレートリミット
GET /product_catalogs15分あたり 1,000
POST /product_catalogs15分あたり 20
PUT /product_catalogs/:product_catalog_id15分あたり 20
DELETE /product_catalogs/:product_catalog_id15分あたり 20

​
バッチ製品 API

HTTP メソッドレートリミット
GET /product_catalogs/:product_catalog_id/products15分あたり 1,000
PUT /product_catalogs/:product_catalog_id/products15分あたり 600
DELETE /product_catalogs/:product_catalog_id/products15分あたり 150

​
Product Sets

HTTP メソッドレートリミット
GET /product_catalogs/:product_catalog_id/product_sets15分あたり2,000件
POST /product_catalogs/:product_catalog_id/product_sets15分あたり100件
PUT /product_catalogs/:product_catalog_id/product_sets/:product_set_id15分あたり500件
DELETE /product_catalogs/:product_catalog_id/product_sets/:product_set_id15分あたり100件

​
商品フィード

HTTP メソッドレートリミット
GET /product_catalogs/:product_catalog_id/product_feeds15分あたり 1,000件
POST /product_catalogs/:product_catalog_id/product_feeds15分あたり 20件
PUT /product_catalogs/:product_catalog_id/product_feeds/:product_feed_id15分あたり 20件
DELETE /product_catalogs/:product_catalog_id/product_feeds/:product_feed_id15分あたり 20件
⌘I