商品カタログ非公開プレビュー

AI エージェントの検出のために構造化された製品データと在庫データを Stripe と共有する方法をご紹介します。

商品フィードと在庫フィードの仕様を使用して、構造化された商品データと在庫データを Stripe と共有し、検索とショッピングのためにカタログを AI エージェントに配信します。商品フィードの完全な送信から始めて、在庫レベルと可用性を最新の状態に保つために在庫フィードの差分更新を送信できます。

製品フィードの仕様

製品フィードを使用して、構造化されたカタログ全体 (タイトル、説明、識別子、価格設定、フルフィルメント、メディアなど) を提供します。各行は製品またはバリエーションを表します。

フィードを準備する: このドキュメントのフィールドリファレンスを使用してカタログをフォーマットします。各フィールドには、サンプル値、検証ルール、および必須、推奨、オプションのいずれかが含まれます。
フィードの配信: Stripe API を使用して、CSV 形式でフィードを安全に送信します (導入の詳細は今後予定)。各行は 1 つの商品またはバリアントを表します。本番環境に移行する前に、サンドボックスエンドポイントに最初のフィードの全文を送信して、データが正しく解析され、フィールドのすべての要件を満たしていることを確認します。
データのインデックス作成とクリーンアップ: データを検証してクリーンアップし、Stripe カタログにインデックスを作成して、各エージェントが必要とする形式に変換します。
Keep your data current: Refresh your feed frequently. Any changes to product attributes, pricing, or fulfillment details should be updated as soon as they occur to maintain customer trust and prevent stale listings.

フィード処理モード

商品フィードのアップサートでは、アップサートモードを使用します。各行は、id で識別される商品の挿入または更新を表します。

ID が存在しない場合は、商品が作成されます。
id がすでに存在する場合は、その行で指定された値で製品が更新されます。
ファイルに含まれていない商品は変更されません。

削除の動作

フィードを使用して商品またはバリエーションを削除するには、CSV にオプションの delete 列を含めます。削除する商品を true に設定します。保持する商品については、false に設定するか、このフィールドを空白のままにします。

商品カタログのフィールドリファレンス

以降のセクションで、Stripe カタログで使用されるスキーマ全体をレビューします。各テーブルには、データ型、例、要件が記載されています。

基本的な商品データ

各商品を一意に定義する必須の識別子と説明文を指定します。

フィールド	データタイプ	例	要件	備考
id	文字列 (英数字)	`SKU12AB3456`	必須	商品の一意の識別子可能な場合は製品の SKU を使用最大 100 文字データを更新するときは、ID を同じにしてください
title	文字列 (UTF-8 テキスト)	`メンズフローラルポロシャツ`	必須	商品のタイトル商品を正確に説明し、ランディングページのタイトルと一致させます。最大 150 文字すべて大文字を避ける
説明	文字列 (UTF-8 テキスト)	`Bring a burst of fun to your golf game with this Men's Floral Polo`	必須	商品の説明商品に関する情報のみを含めます。店舗へのリンク、販売情報、競合他社、他の商品、アクセサリーの詳細は含めないでください。最大 5,000 文字プレーンテキストのみ
リンク	URL (RFC 1738)	`https://example.com/product/SKU12AB3456`	必須	商品のランディングページ認証済みドメイン名を使用する `http` または `https` で始まる (`https` を推奨) `http` 200 で解決する必要がある (リンク切れがない)

製品 ID

世界中で認知されているこれらの識別子を使用して、検索や照合において商品を差別化します。

フィールドデータタイプ例要件備考

フィールド	データタイプ	例	要件	備考
ブランド	文字列	`Stripe`	映画、書籍、音楽録音ブランドを除くすべてに必須	商品のブランド名一般に消費者に認知されている商品のブランド名を提供します。最大 70 文字
gtin	文字列 (数値での GTIN、UPC、ISBN)	`3234567890126`	推奨	製品のグローバル取引項目番号 (GTIN) 最大 50 文字ダッシュとスペースを除く
mpn	文字列 (英数字)	`STR12345`	GTIN がない場合は必須です	製品のメーカー部品番号 (MPN) メーカーから割り当てられた MPN のみを提出する最大 70 文字

ブランド

文字列

Stripe

映画、書籍、音楽録音ブランドを除くすべてに必須

商品のブランド名

一般に消費者に認知されている商品のブランド名を提供します。
最大 70 文字

gtin

文字列

(数値での GTIN、UPC、ISBN)

3234567890126

推奨

製品のグローバル取引項目番号 (GTIN)

最大 50 文字
ダッシュとスペースを除く

mpn

文字列

(英数字)

STR12345

GTIN がない場合は必須です

製品のメーカー部品番号 (MPN)

メーカーから割り当てられた MPN のみを提出する
最大 70 文字

メディア

商品を正確に表現するために、ビジュアルメディアとオプションのリッチメディアを提供します。

フィールド	データタイプ	例	要件	備考
image_link	URL (RFC 1738)	`https://example.com/image1.jpg`	必須	商品のメイン画像の URL JPEG または PNG 形式を使用 `http` または `https` で始まる必要があります (`https` を推奨) パブリックアクセス可能であること推奨最小サイズ: 800 × 800 ピクセル透かし、テキストオーバーレイ、またはプロモーショングラフィックを避ける
additional_image_link	URL 配列 (RFC 1738)	`https://example.com/image2.jpg,…`	任意	商品の追加画像の URL `image_link` と同じ要件に従う最大 10 枚の画像に対応複数の角度、パッケージ、コンテキストに応じたビューを使用する 1 つの画像を送信するには、(エンコードされた) URL: `https://www.example.com/image2.jpg` を送信します複数の画像 (最大 10 枚) を送信するには、各 URL をカンマで区切ってください (`https://www.example.com/image2.jpg,https://www.example.com/image3.jpg` など)。 URL 内のカンマはすべて (%2C として) エンコードしてください。ただし、各画像 URL の区切りに使用するカンマはエンコードしないでください。`https://www.example.com/image2%2C3.jpg,https://www.example.com/image2%2C4.jpg`
video_link	URL (RFC 1738)	`https://youtu.be/12345`	任意	使用中の商品や開梱中の商品を紹介する商品動画一般にアクセス可能である必要がある (YouTube、Vimeo、MP4 の直リンクなど) 推奨される形式: MP4、MOV、WebM 推奨期間: 15 ～ 60 秒商品に関連する場合にのみ音声を含める (サウンドデモなど) メイン画像と同じ商品を明確に示す
model_3d_link	URL (RFC 1738)	`https://www.example.com/products/xyz.glb`	任意	製品の 3D モデルを表示するための追加リンク推奨フォーマット: GLB または GLTF パブリックアクセス可能であること最適な読み込みのためにファイルサイズを 20 MB 未満に抑えるモデルが商品の物理的な形状と色を正確に表していることを確認する

項目情報

正確なフィルタリングと分類の配置のために、物理的特性と分類を説明します。

フィールド	データタイプ	例	要件	備考
条件	列挙値 (`new`、`refurbished`、`used`)	`new`	商品の状態が新品と異なる場合は必須	販売時の商品の状態 `new`: 元の未開封の梱包の新品項目 `refurbished`: プロフェッショナルが作業注文に復元し、保証付きで、元の梱包材が欠落している可能性があります `used`: 以前使用、元の梱包を開封済み、または未開封
google_product_category	文字列 (Google 製品分類の値。カテゴリ ID の数値、またはカテゴリのフルパス)。	`2271` または `アパレルおよびアクセサリー > 衣料品 > ドレス`	推奨	事前定義された Google 製品カテゴリー最も関連性の高いカテゴリーのみを含める完全なカテゴリーパスまたは数値のカテゴリー ID のいずれかを含めますが、両方を含めることはできません。可能な場合はカテゴリー ID を使用してください。
product_category	文字列 (カテゴリの分類)	`Apparel & Accessories > Clothing > Outerwear`	`google_product_category` がない場合は必須です	商品に定義する商品カテゴリー区切り文字として `>` を使用全カテゴリーを含めるダッシュとスペースを除く
age_group	列挙値 (`newborn`、`infant`、`toddler`、`kids`、`adult`)	`infant`	任意	商品が意図されている対象年齢層 `newborn`: 0 ～ 3 か月 `infant`: 3 ～ 12 か月 `toddler`: 1 ～ 5 歳 `kids`: 5 ～ 13 歳 `adult`: 10 代以上
素材	文字列	`leather`	一連のバリアントで異なる商品を区別する場合に必要です	商品の主な生地または素材最大 100 文字
長さ	番号と単位 (`cm` および `in`)	`20 in`	任意	商品の長さ各商品の寸法属性 (商品の長さ、幅、高さなど) に同じ単位を使用する小数点以下の値がサポートされています
幅	番号と単位 (`cm` および `in`)	`20 in`	任意	商品の幅各商品の寸法属性 (商品の長さ、幅、高さなど) に同じ単位を使用する小数点以下の値がサポートされています
高さ	番号と単位 (`cm` および `in`)	`20 in`	任意	商品の高さ各商品の寸法属性 (商品の長さ、幅、高さなど) に同じ単位を使用する小数点以下の値がサポートされています
重量	番号と単位 (`lb`、`oz`、`g`、`kg`)	`2.5 lb`	任意	商品の重量この属性に実際に組み立てられた製品の重量を使用する小数点以下の値がサポートされています

バリアント

関連する SKU が 1 つの親の下にグループ化されるように、色やサイズなどのバリアントの関係を定義します。バリアントを送信する場合は、すべてのバリアントに同じ item_group_id を含める必要があります。

フィールド	データタイプ	例	要件	備考
item_group_id	文字列	`Shoe1234`	バリアントが存在する場合は必須です	さまざまなバリエーションの製品グループの ID バリアントのグループごとに一意の値を使用します。可能な場合は親 SKU を使用します。商品データを更新するときは、値を同じにしてください最大 70 文字同じ `item_group_id` を共有するすべての商品に、同じバリアント属性セットを使用します。たとえば、ドレスが 2 色 2 サイズの場合、各バリアントには色とサイズの両方の値を含める必要があります。
item_group_title	文字列 (UTF-8 テキスト)	`Shoes`	任意	商品グループのタイトル関連するバリエーションのグループを表す明確で判読可能な名前を使用する (「メンズランニングシューズ」など) 最大 150 文字大文字はすべて使用しないでください
カラー	文字列	`Black`	推奨 (アパレル)	商品の色商品に複数の色がある場合は、プライマリーカラーをリストします。 Recommended length: ≤ 40 characters Maximum length: 100 characters
サイズ	文字列	`10`	推奨 (アパレル)	商品のサイズ最大 20 文字
size_system	国コード (ISO 3166)	`US`	推奨 (アパレル)	サイズ体系 2 文字の国コード
gender	列挙値 (`male`、`female`、`unisex`)	`male`	推奨 (アパレル)	商品の意図する性別

可用性と在庫

リアルタイムの在庫状況と数量を提供して、購入の正確性を維持します。

フィールド	データタイプ	例	要件	備考
対応状況	列挙値 (`in_stock`、`out_of_stock`、`preorder`、`backorder`)	`in_stock`	すべての商品に必須	商品の在庫状況
availability_date	日付 (ISO 8601)	`2026-02-24`	商品の在庫が `preorder` に設定されている場合は必須です	予約注文された商品が配送可能になった日
expiration_date	日付 (ISO 8601)	`2026-12-31`	任意	商品が表示されない日付
inventory_not_tracked	ブール値 (`true` または `false`)	`false`	任意	商品の在庫を追跡するかどうかを指定します。 `true`: 在庫は追跡されません (デジタル商品や受注生産など)。`inventory_quantity` は空白にする必要があります。 `false`: 在庫が追跡され、`inventory_quantity` が必要です
inventory_quantity	整数 (非負の整数)	`100`	`inventory_not_tracked` が `false` の場合は必須です。`true` の場合は空白のままにします。	この項目で使用可能な販売可能単位。`inventory_not_tracked` が `true` の場合は空白のままにします。

価格とプロモーション

表示とプロモーションロジックの料金情報を指定します。

フィールド	データタイプ	例	要件	備考
価格	数値と通貨 (ISO 4217)	`15.00 USD`	すべての商品に必須	商品の価格
sale_price	数値と通貨 (ISO 4217)	`12.99 USD`	任意	割引価格
sale_price_effective_date	日付 (ISO 8601)	`2025 年 12 月 01 日 / 2025 年 12 月 15 日`	`sale_price` を指定した場合は必須	販売期間開始日と終了日は `/` で区切ります
stripe_product_tax_code	文字列 (Stripe 製品課税コード (PTC))	`txcd_99999999`	税金計算に Stripe Tax を使用する場合に必要	Stripe の製品課税コードを使用して、正確な税金計算のために商品を分類します。これらのコードは、Stripe が商品の種類と管轄区域に基づいて正しい税率を判断するのに役立ちます。
tax_behavior	列挙値 (`inclusive` または `exclusive`)	`外税`	任意	商品の価格に、適用される税金 (内税) を含めるか (外税) を含めるか含めないかを指定します。省略すると、デフォルト値は外税になります。
applicable_fees	文字列 (`country:region:fee_label:fee_amount`: 各オプションをコロン区切りの値として入れ、複数のエントリはカンマで区切ります。)	`US:CA:Recycling Fee:0.25 USD,DE:ALL:Bottle Deposit:0.10 EUR`	オプション (規制または地域の手数料が適用される場合は必須)	このフィールドを使用して、製品タイプと地域に適用されるユニット単位の手数料と追加料金を指定します。これらの手数料は、基本製品価格に含めないでください。決済とレポートで個別の項目として表示されることを目的としています。各手数料をコロン区切りの値としてフォーマットします。 `country` (必須):ISO 3166-1 alpha-2 国コード (US、DE など)。 `region` (必須): 地域、州、準州、または都道府県 (CA など) を指定します。指定した国内のすべての地域または州に適用するには、`ALL` を使用します。 `fee_label` (必須): 手数料の判読可能な名前 (リサイクル手数料、ボトル入金、エコ決済など)。名前にコロンを使用しないでください。 `fee_amount` (必須): 小数点にピリオドを使用し、ISO 4217 通貨コード (5.00 USD など) を使用する固定の単位手数料。

フルフィルメント

配送オプション、料金、配送予定日を指定します。

フィールドデータタイプ例要件備考

フィールド	データタイプ	例	要件	備考
shipping	文字列 (`country:region:service:speed_range:price`: 各オプションをコロン区切りの値として入力し、複数のエントリはカンマで区切ります)。	`US:ALL:Standard Shipping:3-5:0.00 USD,US:ALL:Expedited Shipping:1-2:12.99 USD`	商品が配送可能な場合 (物品など) に必要	商品の配送料金、配送速度、商品の配送先。各配送オプションをコロン区切りの値としてフォーマットします。 `country` (必須): 商品の配送先となる国を示す ISO 3166-1 alpha-2 の国コードを指定します (US、DE など)。 `region` (必須): ISO 3166-2 サブディビジョンコード (アメリカのサブディビジョンコード) を使用して、国プレフィックス (VA や NY など) なしで、地域、州、領土、都道府県を指定します。ワイルドカードとして ALL を使用し、指定した国内のすべての地域または州に配送ルールが適用されることを示します。 `service` (必須): サービスの判読可能な名前(Standard や Express の配送オプションなど)。 `speed_range` (オプション): 配送に必要な最小日数と最大日数 (例: 3 ～ 5 日) `価格` (必須): 固定配送料を送信し、小数点と ISO 4217 通貨コードとしてピリオドを使用します (例: 3.00 USD)
free_shipping_threshold	文字列 (`国:価格`)	`US:16.00 USD`	任意	注文総額が配送料無料以上 `country` (必須): ISO 3166-1 alpha-2 国コード `price_threshold` (必須): 注文総額がこの額以上の場合に送料無料

shipping

文字列

(country:region:service:speed_range:price: 各オプションをコロン区切りの値として入力し、複数のエントリはカンマで区切ります)。

US:ALL:Standard Shipping:3-5:0.00 USD,US:ALL:Expedited Shipping:1-2:12.99 USD

商品が配送可能な場合 (物品など) に必要

商品の配送料金、配送速度、商品の配送先。

各配送オプションをコロン区切りの値としてフォーマットします。
- country (必須): 商品の配送先となる国を示す ISO 3166-1 alpha-2 の国コードを指定します (US、DE など)。
- region (必須): ISO 3166-2 サブディビジョンコード (アメリカのサブディビジョンコード) を使用して、国プレフィックス (VA や NY など) なしで、地域、州、領土、都道府県を指定します。ワイルドカードとして ALL を使用し、指定した国内のすべての地域または州に配送ルールが適用されることを示します。
- service (必須): サービスの判読可能な名前(Standard や Express の配送オプションなど)。
- speed_range (オプション): 配送に必要な最小日数と最大日数 (例: 3 ～ 5 日)
- 価格 (必須): 固定配送料を送信し、小数点と ISO 4217 通貨コードとしてピリオドを使用します (例: 3.00 USD)

free_shipping_threshold

文字列

(国:価格)

US:16.00 USD

任意

注文総額が配送料無料以上

country (必須): ISO 3166-1 alpha-2 国コード
price_threshold (必須): 注文総額がこの額以上の場合に送料無料

パフォーマンスとレビューシグナル

パフォーマンスとレビューのシグナルを共有して、AI エージェントとランキングシステムが高品質で信頼できる製品を識別できるようにします。

これらのフィールドはオプションですが、推奨されます。エージェントインターフェイス全体での発見性、ランキング、パーソナライゼーションが向上します。
集計された指標のみを提供し、ユーザーレベルのデータや個人を特定できる情報は除外します。
これらの指標を定期的に (毎週など) 更新して、正確性を維持します。

フィールド	データタイプ	例	要件	備考
popularity_score	番号 (0–5 段階)	`4.7`	推奨	この商品またはバリエーションの人気指標の集計カタログ全体で一貫した 0 ～ 5 段階 (0 = 最低、5 = 最高) を使用閲覧数、カートに追加イベント、コンバージョン、売上ランクなどのシグナルからこれを導き出す一貫した集計期間 (過去 90 日間など) を使用して鮮度を確保する
return_rate	番号 (0 ～ 100 (`%` 記号は含めないでください))	`2.0`	推奨	この商品またはバリエーションについて返品されたユニットの割合 0 ～ 100 の数値パーセンテージで表示します (たとえば、2% には 2.0 を使用) 一貫した集計期間を使用する (過去 90 日間など)
product_review_count	整数 (非負の整数)	`124`	推奨	この商品またはバリエーションに関連付けられたレビューの合計数 `product_review_rating` の計算に使用される母集団を一致させるレビューが存在しない場合は 0 を使用する可能な場合は認証済の購入レビューを反映
product_review_rating	番号 (1–5 段階)	`4.3`	`product_review_count` が 0 より大きい場合は必須	この商品またはバリエーションの平均レビュー評価カタログ全体で一貫した 1 ～ 5 段階 (1 = 最低、5 = 最高) を使用 `product_review_count`と同じデータセットに対応している必要があります `product_review_count` が 0 の場合はこのフィールドを空白のままにします

フィード処理手順

システムがフィードの各行を処理する方法を制御する操作フィールドを定義します。

フィールドデータタイプ例要件備考

フィールド	データタイプ	例	要件	備考
削除する	ブール値 (`true` または `false`)	`true`	任意	商品またはバリアントに永久削除のマークを付ける `true` の場合、`id` で識別された商品を削除し、その行のその他の列はすべて無視します省略または `false` の場合、行はアップサートとして通常どおり処理されます。

削除する

ブール値

(true または false)

true

任意

商品またはバリアントに永久削除のマークを付ける

true の場合、id で識別された商品を削除し、その行のその他の列はすべて無視します
省略または false の場合、行はアップサートとして通常どおり処理されます。

在庫フィード仕様を使用します

在庫フィードを使用して、カタログ全体を再提出することなく、商品の在庫状況と在庫数量を更新します。倉庫、POS、フルフィルメント、エージェントインターフェイス全体で正確な在庫ステータスを商品に反映します。

製品フィードの同期を維持する: インベントリファイルの ID 値は、メインのカタログフィードにすでに存在している必要があります。
インベントリファイルを頻繁に送信: Stripe API を使用して CSV 形式で更新を追加します。
部分的な更新を送信: 変更された SKU のみを含めます。含まれていない SKU は、最新の既知の在庫状態を保持します。

在庫フィードフィールドの参照

在庫フィードのフィールド

リアルタイムの在庫状況と数量を提供して、購入の正確性を維持します。

フィールド	データタイプ	例	要件	備考
id	文字列 (英数字)	`SKU12AB3456`	必須	主要な製品フィードの `ID` と一致している必要があります。この値は、主要な識別子です。
対応状況	列挙値 (`in_stock`、`out_of_stock`、`preorder`、`backorder`)	`in_stock`	すべての商品に必須	商品の在庫状況
availability_date	日付 (ISO 8601)	`2026-02-24`	商品の在庫が `preorder` に設定されている場合は必須です	予約注文された商品が配送可能になった日
inventory_quantity	整数 (非負の整数)	`100`	すべての商品に必須	販売可能ユニット

メモ

商品カタログ非公開プレビュー

AI エージェントの検出のために構造化された製品データと在庫データを Stripe と共有する方法をご紹介します。

製品フィードの仕様

フィード処理モード

削除の動作

商品カタログのフィールドリファレンス

基本的な商品データ

製品 ID

メディア

項目情報

バリアント

可用性と在庫

価格とプロモーション

フルフィルメント

パフォーマンスとレビューシグナル

フィード処理手順

在庫フィード仕様を使用します

在庫フィードフィールドの参照

在庫フィードのフィールド