ローカル商品在庫フィードとは、各店舗で販売する商品のリストです。属性は、すべての商品アイテムに必須の属性、特定の商品アイテムに必須の属性、指定が推奨される属性に分類されます。
在庫価格と在庫状況は頻繁かつ店舗ごとに変化する可能性があります。フィードの頻度を上げると、在庫データをより頻繁に更新できるようになります。フィードの頻度に関して問題が発生した場合は、お問い合わせフォームを使用してサポートチームにお問い合わせください。また、店舗拠点の情報が Merchant Center アカウントに同期されるまで最大で 24 時間かかることがあります。したがって、アカウントをリンクした後、またはビジネス プロフィールで店舗コードを変更した後は、そこから 24 時間経ってから在庫フィードをアップロードすることをおすすめします。
API を使用して商品データを送信する場合は、Google Content API の詳細をご覧ください。
ローカル商品在庫フィードの登録
ファイル形式: ローカル商品在庫フィードにはタブ区切りのテキスト ファイル、XML ファイル、API を使用できます。
新しいローカル商品在庫フィードの作成: 新しいローカル商品在庫フィードの作成と登録は、こちらの手順に沿って行ってください。
重要:このローカル商品在庫フィード仕様に記載されている属性名の中には、スペースやアンダースコアを含むものがあります。属性名の文字やスペースを正しく登録できるよう、使用するファイル形式に応じて以下のガイドラインを遵守してください。
- タブ区切りフィード: スペースの使用が必須。属性名にアンダースコアが含まれている場合は、「_」をスペースに置き換えてください。
- XML API または JSON API: アンダースコアの使用が必須。Google で受信されると、アンダースコアは空白文字に変換されます。
属性要件のまとめ
属性 | 登録要件 | |
---|---|---|
必須の在庫詳細 |
店舗コード |
すべての商品で必須です。 注: 店舗コード |
任意の在庫詳細 |
セール価格有効期間 在庫数 |
価格、在庫数、当日配達の詳細を示すために、必要に応じてフィード内の各商品アイテムに登録することが推奨されます。 国内共通のデフォルト価格の場合、価格は省略可能です。店舗固有の価格が変更された場合は、価格を指定する必要があります。 |
任意の店舗受け取り詳細 |
受け取り方法 受け取りに関するサービスレベル契約 |
必要に応じてフィード内の店舗受け取りが可能なすべての商品アイテムに登録することが推奨されます。 重要: 2024 年 9 月 1 日より、受け取り方法 |
任意のローカル配送の詳細 | ローカル配送ラベル [local shipping label] |
当日配達が有効であり、1 つの店舗において一部の商品のみが当日配達の対象となる場合、これをフィードに登録する必要があります。 |
必須の在庫詳細
これらの属性は各店舗の商品アイテムごとの基本的な在庫情報を表します。
[store_code]
- ビジネス プロフィールの店舗 ID
各ローカル店舗を識別する英数字の固有 ID です。この属性は大文字と小文字が区別され、ビジネス プロフィールに登録した店舗コードと一致している必要があります。
指定するケース: フィード内のすべての商品アイテムに必須です。
型 | テキスト(文字列) |
テキスト / タブ区切りの例 | Store123 |
XML の例 | <g:store_code>Store123</g:store_code> |
[id]
- 商品アイテムの ID
全店舗共通で商品を表す、英数字の固有商品 ID です。
同じ商品アイテムを複数の店舗で販売している場合は、複数の店舗コードに同じ ID が表示されます。店舗ごとに 1 つの ID [id]
属性を指定し、その店舗の商品アイテムの在庫有無については、在庫状況 [availability]
属性を使用してください。
1 つの国で同じタイプのフィードが複数ある場合でも、それぞれのフィード内の商品アイテムには固有の ID が必要です。在庫全体にわたって固有の SKU が使用され、下記の要件を満たしている場合は、この属性に対して SKU を使用することをおすすめします。
指定するケース: フィード内のすべての商品アイテムに必須です。
型 | テキスト(文字列) |
テキスト / タブ区切りの例 | 421486 |
XML の例 | <g:id>421486</g:id> |
重要:
- メインフィードとローカル商品在庫フィードで、同じ ID 値を使用してください。
- 先頭と末尾の空白文字と改行文字(0x0D)は削除されます。
- 改行文字(0x0D)と空白文字(空白文字プロパティを持つ Unicode 文字)は、単一の空白文字(0x20)に置き換えられます。
- 有効な Unicode 文字のみ使用できます。ただし、次の文字は使用できません。
- 制御文字(改行 0x0D を除く)
- 機能文字
- 私用領域文字
- サロゲートペア
- 未割り当ての符号位置(具体的には、0x10FFFF よりも大きいすべての符号位置)
- 商品アイテムの登録後は、ID
[id]
をデータフィードの更新時に変更したり、後で別の商品に使用したりすることはできません。 - 実店舗で購入可能な商品にのみ指定してください。
[availability]
- 商品アイテムの在庫状況
- 在庫あり [in_stock]: ローカル店舗に商品アイテムの在庫があることを表します。
- 在庫なし [out_of_stock]: ローカル店舗に商品アイテムの在庫がないことを表します。
- 在庫僅少 [limited_availability]: ローカル店舗に商品アイテムの在庫がわずかしかないことを表します。
- 見本展示あり [on_display_to_order]: ローカル店舗で商品アイテムが見本展示されていることを表します(倉庫から発送する必要がある冷蔵庫など)。在庫数
[quantity]
属性も登録する場合は、見本展示あり [on_display_to_order] に値「1」を指定します。
型 | テキスト(文字列)。指定できる値: in_stock、out_of_stock、limited_availability、on_display_to_order の 4 つのみ。 |
テキスト / タブ区切りの例 | in_stock |
XML の例 | <g:availability>in stock</g:availability> |
任意の在庫詳細
これらの属性を使用して、商品アイテムの価格、数量、在庫に関する追加情報を指定できます。
[price]
- 商品アイテムの価格
商品アイテムの通常価格です。在庫フィードとメインフィードの両方で価格の値を登録した場合、関連付けられているショップでは、メインフィードの価格よりも在庫フィードの価格が優先されます。
指定するケース: フィード内のすべての商品アイテムに必須です。
型 | 数値(通貨は、店舗の所在国を基に自動的に割り当てられます。) |
テキスト / タブ区切りの例 | 29800 |
XML の例 | <g:price>29800</g:price> |
[sale_price]
- 商品アイテムの公表されているセール価格
店舗ごとに掲載する一時的なセール価格です。このフィードとローカル商品フィードの 価格 [price]
属性より優先されます。
セール価格が指定されている商品アイテムには、セール価格有効期間 [sale_price_effective_date]
属性を登録して、セール価格を掲載する期間も指定することをおすすめします。セール価格有効期間を指定していない場合、フィードを使ってセール価格を送信する限り、そのセール価格が適用され続けます。
型 | 数値 |
テキスト / タブ区切りの例 | 27800 |
XML の例 | <g:sale_price>27800</g:sale_price> |
[sale_price_effective_date]
属性に有効期限の値を含めます。[sale_price_effective_date]
- 商品アイテムのセール期間の日付範囲
公表されたセール価格が適用される日付範囲です。
詳しくは、セール価格の定義をご覧ください。
型 | テキスト(文字列)。ISO8601 形式で、開始日と終了日をスラッシュ(/)で区切る |
テキスト / タブ区切りの例 |
UTC の例: 時刻の値はすべて 24 時間表記を使用します。 |
XML の例 | <g:sale_price_effective_date>2021-07-19T09:00-0800/2021-07-26T21:00-0800</g:sale_price_effective_date> |
[quantity]
- 商品アイテムの在庫数
店舗の商品アイテム在庫数です。一時的に在庫がない商品アイテムを送信する場合は、この属性に「0」を指定してください。
在庫数は必須属性ではなくなりました。代わりに、すべての在庫に在庫状況を登録してください。
型 | 整数 |
テキスト / タブ区切りの例 | 4 |
XML の例 | <g:quantity>4</g:quantity> |
重要:
- Google では、在庫あり [in_stock] は商品アイテムの在庫が 3 点以上、在庫僅少 [limited_availability] は 1~2 点、在庫なし [out_of_stock] は 0 点であるとみなします。
- 在庫数と在庫状況を登録する場合、在庫は在庫状況と在庫数のうち、いずれか低い方の値に基づいて分類されます。
任意の店舗受け取り詳細
店舗固有の受け取りに関する情報を指定するには、ローカル商品在庫フィードにこれらの属性を追加します。
受け取り方法[pickup_method]
- 商品アイテムの店舗受け取りオプション
[pickup_method]
を指定しなくても、商品の店舗受け取りを有効にできるようになります。この商品アイテムの受け取りオプションを指定します。
- buy [購入]: すべての購入手続きをオンラインで行う商品アイテム
- reserve [予約]: オンラインで予約して店舗で購入手続きを行う商品アイテム
- ship to store [店舗受け取り]: オンラインで購入し、購入者が受け取る店舗に配送される商品アイテム
- not supported [対象外]: 店舗受け取りを利用できない商品アイテム
型 | テキスト(文字列)。次の 4 つの値のいずれかを指定する必要があります。
「buy」、「reserve」、「ship to store」、「not supported」 |
テキスト / タブ区切りの例 | buy |
XML の例 | <g:pickup_method>buy</g:pickup_method> |
[pickup_sla]
- 店舗受け取りの用意ができるまでの期間
注文した時点から商品が受け取り可能になる予定日を指定します。
- 同日: 注文を行った日と同日に商品アイテムを受け取ることができることを示します(受付終了時刻になる前の注文のみ)。
- 翌日: 注文を行った日の翌日に商品アイテムを受け取ることができることを示します。
- 2 日: 購入者が受け取る店舗に商品アイテムが配送されるまでの期間が 2 日以内であることを示します。
- 3 日: 購入者が受け取る店舗に商品アイテムが配送されるまでの期間が 3 日以内であることを示します。
- 4 日: 購入者が受け取る店舗に商品アイテムが配送されるまでの期間が 4 日以内であることを示します。
- 5 日: 購入者が受け取る店舗に商品アイテムが配送されるまでの期間が 5 日以内であることを示します。
- 6 日: 購入者が受け取る店舗に商品アイテムが配送されるまでの期間が 6 日以内であることを示します。
- 複数週: 購入者が受け取る店舗に商品アイテムが配送されるまでの期間が 1 週間より長いことを示します。
型 | テキスト(文字列)。次の 8 つの値のいずれかを指定する必要があります。
「same day」、「next day」、「2-day」、「3-day」、「4-day」、「5-day」、「6-day」、「multi-week」 |
テキスト / タブ区切りの例 | same day |
XML の例 | <g:pickup_sla>same day</g:pickup_sla> |
任意のローカル配送の詳細
ローカル配送の情報については、この属性をローカル商品在庫フィードに追加してください。
ローカル配送ラベル [local_shipping_label]
当日配達が有効であり、特定の店舗のローカル在庫の一部の商品のみを当日配達の対象にする場合、ローカル商品在庫フィードにローカル配送ラベル [local_shipping_label]
属性を追加する必要があります。
この属性の値には、アカウント単位の当日配達の配送設定で作成した当日配達ラベルの名前を指定してください。個々の当日配達ラベルは、当日配達の設定における一意のグループを表し、ローカル商品在庫フィード内で、当日配達の対象として選択する商品に追加します。
当日配達の対象となる商品アイテムの詳細設定として、配達可能な範囲(半径)をマイルまたは km 単位で設定できます。当日配達の受付終了時間を設定することもできます。閉店時間の何時間前まで、または特定の時間を指定して設定します。当日配達が可能な商品アイテムの注文を、受付終了時間を過ぎてから受けた場合に、翌日配達が可能かどうかを指定できます。
すべての店舗のすべての商品が当日配達の対象である場合や、対象となる店舗リスト内のすべての商品が当日配達の対象である場合は、この属性は省略可能です。当日配達について詳しくは、こちらをご覧ください。