| フィールド名 |
説明 |
ルール / 注: |
| 商品ID(エクスポートのみ) |
各商品に対してシステムが生成する一意のIDで、マーチャントがproduct_idを取得するために使用します |
- インポート時に入力された値はすべて無視されます。
- 最大長は64文字です。
|
| バリエーションID(エクスポートのみ) |
各バリエーションに対してシステムが生成する一意のIDで、更新時に既存のバリエーションを識別するために使用します |
|
| Handle(任意) |
商品タイトルから生成される一意の商品識別子で、インポート時に商品を照合するための主要な識別子として使用されます |
- 列は保持する必要がありますが、値は空白でもかまいません。
- 更新時は既存のHandleと完全に一致する必要があります。そうでない場合は新しい商品として扱われます。
- 一致すれば商品が更新されます。
- 一致しなければ新しい商品が作成されます。
- 複数のバリエーションがある商品では、最初の行のみ入力し、以降の行は空白にできます。
- スペースや特殊文字は自動的に「-」に変換されます(例:「apple phone」→「apple-phone」)。
|
注:Handleが一致する場合、このフィールドは更新時に上書きされませんが、その他の関連情報はすべて更新されます。 |
|
| タイトル(必須) |
商品名またはタイトル |
- 列は保持する必要があり、値は空白にできません。
- 最大長は255文字です。これを超えるとインポートが失敗します。
- 複数のバリエーションがある商品では、最初の行のみ入力し、以降の行は空白にできます。
- このフィールドは「空白フィールドを無視」設定の影響を受けません。空白のままだとインポートが失敗します。
|
| サブタイトル(任意) |
商品のサブタイトルまたはキャッチフレーズ |
- 列は保持する必要がありますが、値は空白のままにできます。
- 最大長は400文字です。超過した内容は自動的に切り捨てられます。
- 複数のバリエーションがある商品は、最初の行のみ入力し、以降の行は空白のままにしてください。
|
| 商品説明(任意) |
詳細な商品説明 |
- 列は保持する必要がありますが、値は空白のままにできます。
- プレーンテキストとHTMLの両方がサポートされています。
- 改行や太字などの書式を適用するには、HTMLコードが必要です。
- プレーンテキストの場合は、追加のスタイルなしで内容を直接入力してください。
- 複数のバリエーションがある商品は、最初の行のみ入力し、以降の行は空白のままにしてください。
|
| SPU(任意) |
マーチャント定義の内部商品識別子 |
- 列は保持する必要がありますが、値は空白のままにできます。
- 最大長は255文字です。これを超えるとインポートに失敗します。
- 絵文字はサポートされておらず、インポートに失敗します。
- 複数のバリエーションがある商品は、最初の行のみ入力し、以降の行は空白のままにしてください。
|
| ブランド(任意) |
商品ブランドまたは製造元 |
- 列は保持する必要がありますが、値は空白のままにできます。
- 最大長は255文字です。超過した内容は自動的に切り捨てられます。
- 複数のバリエーションがある商品は、最初の行のみ入力し、以降の行は空白のままにしてください。
|
| タグ(任意) |
カテゴリ分けや検索フィルタリングに使用されるタグ |
- 列は保持する必要がありますが、値は空白のままにできます。
- 複数のタグは1行にカンマで区切って入力してください(例:red, summer)。
- タグは大文字・小文字を区別しません(ABC = abc)。
- 商品ごとに最大250個のタグが許可されており、それを超えるタグは無視されます。
- 複数のバリエーションがある商品は、最初の行のみ入力し、以降の行は空白のままにしてください。
|
| カテゴリ(任意) |
商品が属するカテゴリのハンドル |
- 列は保持する必要がありますが、値は空白のままにできます。
- カテゴリのハンドル(タイトルではなく)を使用し、スペースは「-」に変換してください。
- 複数のカテゴリハンドルはカンマで区切ってください。
- スマート分類はサポートされていません。
- 複数のバリエーションがある商品では、最初の行のみ入力し、以降の行は空白のままにできます。
|
警告: この列をシートから削除すると、既存のカテゴリがクリアされる可能性があります。慎重に操作してください。 |
|
| マスター画像(任意) |
メイン商品画像のURL |
- 列は保持する必要がありますが、値は空白のままにできます。
- 1行につき1つの画像URLを入力してください。各商品は最大500枚の画像をサポートします。
- 対応フォーマットはJPG、JPEG、PNG、GIF、WebPです。
- 各画像のサイズは10MB以下でなければなりません。これを超えるとインポートに失敗します。
- 画像URLの最大長は512文字です。これを超えるとインポートに失敗します。
|
| 画像代替テキスト(任意) |
商品画像の代替テキスト(SEOおよびアクセシビリティ用) |
- 列は保持する必要がありますが、値は空白のままにできます。
- 最大長は512文字です。超過分は自動的に切り捨てられます。
|
| SEOタイトル(任意) |
商品ページのSEOタイトル、検索結果に表示されます |
- 列は保持する必要がありますが、値は空白のままにできます。
- コア商品キーワードを含めることを推奨します。
- 最大長は255文字です。これを超えると切り捨てられ、SEOパフォーマンスに影響を与える可能性があります。
- 複数のバリエーションがある商品では、最初の行のみ入力し、以降の行は空白のままにできます。
|
| SEOディスクリプション(任意) |
商品ページのメタディスクリプション、検索結果に表示されます |
- 列は保持する必要がありますが、値は空白のままにできます。
- 簡潔にし、コアキーワードを含めることを推奨します。
- 最大長は1,024文字です。これを超えると切り捨てられ、SEOパフォーマンスに影響を与える可能性があります。
- 複数のバリエーションがある商品では、最初の行のみ入力し、以降の行は空白のままにできます。
|
| 公開(任意) |
商品がオンラインストアに公開されているかどうか |
- 列は保持する必要がありますが、値は空白のままにできます。
- 商品を公開するには「Y」、未公開のままにするには「N」を入力してください。
- 空白の場合、デフォルト値は「Y」になります。
- 無効な値はすべて「Y」として扱われます。
- ローカルインポートの場合、値はトグルルールに従います。その他のインポート方法では、値は「Y」に設定されます。
- 複数のバリエーションがある商品の場合、最初の行のみ入力し、以降の行は空白のままにできます。
|
| ステータス(任意) |
商品の利用可能ステータス |
- 列は保持する必要がありますが、値は空白のままにできます。
- サポートされている値は「Y」(有効)、「N」(下書き)、および「archived」です。
- 空白の場合、デフォルト値は「Y」になります。
- 無効な値はデフォルト値「Y」に変換される場合があります。
- ローカルインポートの場合、値はトグルルールに従います。その他のインポート方法では、値は「Y」に設定されます。
- 複数のバリエーションがある商品の場合、最初の行のみ入力し、以降の行は空白のままにできます。
|
| 非表示(任意) |
商品がストアフロントの商品リスト、検索、レコメンデーション、および検索エンジンで見つけられるかどうか。 |
- 列は保持する必要がありますが、値は空白のままにできます。
- 商品をストアフロントの発見から隠すには「Y」、発見可能なままにするには「N」を入力してください。
- 新しい商品作成時に空白の場合、デフォルト値は「N」(表示)になります。
- 既存の商品更新時に空白の場合、現在の値は変更されません。
- 無効な値はすべて「N」(表示)として扱われます。
- 複数のバリエーションがある商品の場合、最初の行のみ入力し、以降の行は空白のままにできます。
|
| 標準化商品タイプ(任意) |
標準的な商品カテゴリ(Google 商品カテゴリに基づく)、税計算に使用されます |
- 列は保持する必要がありますが、値は空白のままにできます。
- 値は事前定義されたカテゴリリスト(Google 商品カテゴリに基づく)から選択する必要があります。カテゴリ名または完全なカテゴリパスのいずれかを入力できます。
- カスタムまたは無効な値は、誤った税計算の原因となる可能性があります。
- 複数のバリエーションがある商品については、最初の行のみ入力し、以降の行は空白のままにできます。
|
| カスタム商品タイプ(任意) |
マーチャント定義の商品カテゴリ |
- 列は保持する必要がありますが、値は空白のままにできます。
- 最大長は255文字です。これを超えるとインポートに失敗します。
- 複数のバリエーションがある商品については、最初の行のみ入力し、以降の行は空白のままにできます。
|
| 作成日時(任意) |
商品の作成日時 |
- 列は保持する必要がありますが、値は空白のままにできます。
- このフィールドは通常必須ではなく、主にデータ移行シナリオ(例:他のプラットフォームからの過去の商品データのインポート)で元の作成日時を保持するために使用されます。
- 値はISO 8601形式に従う必要があります。
- 日付は1990-01-01T00:00:00+08:00より前であってはなりません。
- 空白の場合は、現在のシステム時刻が使用されます。
- 複数のバリエーションがある商品については、最初の行のみ入力し、以降の行は空白のままにできます。
|
| SKU(任意) |
マーチャント定義のバリエーション識別子 |
- 列は保持する必要がありますが、値は空白のままにできます。
- CSVファイルをアップロードする際にこのフィールドを空白にし、同じ商品を更新/上書きし、既存の値を欠落した列に使用するをチェックすると、既存のSKUはクリアされます。
- 各SKUは商品内で一意でなければなりません。
- 商品ごとに最大500のSKUが許可されており、各SKUの最大長は255文字です。
- 複数のバリエーションがある商品については、このフィールドは各行に入力する必要があります。
|
| Option1 名(任意) |
最初のバリエーション属性の名前(例:カラー) |
- 列は保持する必要がありますが、値は空白のままにできます。
- このフィールドは「空白フィールドを無視」設定の影響を受けません。CSVファイルを更新する際、このフィールドの情報をクリアしないでください。クリアすると元のバリエーション値が削除されます。
- 商品は最大5つのオプション名を持つことができ、各名前の最大長は255文字です。
- 複数のバリエーションがある商品では、最初の行のみ入力し、以降の行は空白のままにできます。
|
警告: 更新時にこのフィールドをクリアすると、既存のバリエーション構造が削除される可能性があります。 |
|
| Option1 値(任意、ただしOption1名に値がある場合は必須) |
最初のバリエーション属性の値 |
- 対応するオプション名がある場合、このフィールドは必須になります。
- 列は保持する必要がありますが、値は空白のままにできます。
- このフィールドは「空白フィールドを無視」設定の影響を受けません。CSVファイルを更新する際、このフィールドの情報をクリアしないでください。クリアすると元のバリエーション値が削除されます。
- 各セルには1つの値のみを含めてください。
- 重複する値(スペースをトリムした後)は許可されず、インポート失敗の原因となります。
- 値はバリエーションの組み合わせに基づいて行ごとに入力してください(例:Red-S、Red-Mは別々の行に入力)。
|
警告: 更新時にこのフィールドをクリアすると、既存のバリエーション値が削除される可能性があります。 |
|
| Option2~Option5 名(任意) |
2番目から5番目のバリエーション属性の名前 |
Option1 名と同じルールです。 |
| Option2~Option5 値(任意、対応するオプション名に値がある場合は必須) |
2番目から5番目のバリエーション属性の値 |
Option1 値と同じルールです。 |
| Option1 値の画像(任意) |
最初のバリエーション値の画像URL |
- 列は保持する必要がありますが、値は空白のままにできます。
- 各オプション値は1つの画像のみサポートします。
- 対応フォーマットはJPG、JPEG、PNG、GIF、WebPです。
- 各画像のサイズは10MBを超えてはいけません。
- URLの最大長は512文字です。これを超えるとインポートに失敗します。
|
| Option2~Option5 値の画像(任意) |
2番目から5番目のバリエーション値の画像URL |
Option1 値の画像と同じルールです。 |
| 画像(任意) |
バリエーション(SKU)の画像URL |
- 列は保持する必要がありますが、値は空白のままにできます。
- 各SKUは1つの画像のみ対応しています。
- 対応フォーマットはJPG、JPEG、PNG、GIF、WebPです。
- 各画像は10MBを超えてはいけません。
- URLの最大長は512文字です。これを超えるとインポートに失敗します。
|
| SKU画像代替テキスト(任意) |
バリエーション画像の代替テキスト |
- 列は保持する必要がありますが、値は空白のままにできます。
- 最大長は512文字です。超過した内容は自動的に切り捨てられます。
|
| SKU販売価格(任意) |
バリエーションの販売価格 |
- 列は保持する必要がありますが、値は空白のままにできます。
- 通貨記号なしで数字のみを入力してください。
- 小数点以下2桁まで対応しています。
- 空白の場合、デフォルト値は0になります。
- 負の値は0に変換されます。
- 11桁を超える値は11桁に切り捨てられます(最大値:99999999999)。
- バリエーションのない商品は最初の行のみ入力し、複数バリエーションがある商品は各SKU行に入力してください。
|
| SKU定価(任意) |
バリエーションの定価 |
- 列は保持する必要がありますが、値は空白のままにできます。
- 通貨記号なしで数字のみを入力してください。
- 小数点以下2桁まで対応しています。
- 空白の場合、デフォルト値は0になります。
- 負の値は0に変換されます。
- 11桁を超える値は11桁に切り捨てられます(最大値:99999999999)。
- バリエーションのない商品は最初の行のみ入力し、複数バリエーションがある商品は各SKU行に入力してください。
|
| SKU重量(任意) |
バリエーションの重量値 |
- 列は保持する必要がありますが、値は空白のままにできます。
- 小数点以下2桁までの数字のみを入力してください。
- 負の値は0に変換されます。
- 数値以外の値はインポート失敗の原因となります。
- 12桁を超える値は12桁に切り捨てられます(最大値:999999999999)。
- バリエーションのない商品は最初の行のみ入力し、複数バリエーションの商品は各SKU行にこのフィールドを入力してください。
|
| SKU重量単位(任意) |
バリエーションの重量単位 |
- 列は保持する必要がありますが、値は空白のままにできます。
- 対応する値はg、kg、lb、ozです。
- 無効な値は自動的にgに変換されます。
- 「空白フィールドを無視」設定が無効の場合、このフィールドを空白にすると値はgにリセットされます。
- バリエーションのない商品は最初の行のみ入力し、複数バリエーションの商品は各SKU行にこのフィールドを入力してください。
|
| SKU在庫追跡(任意) |
在庫追跡が有効かどうか |
- 列は保持する必要がありますが、値は空白のままにできます。
- 追跡を有効にするには「T」、無効にするには「F」を入力してください。
- 空白の場合、デフォルト値は「T」になります。
- 無効な値は「T」として扱われます。
- ローカルインポートの場合、値はトグルルールに従います。他のインポート方法では値は「Y」に設定されます。
- 複数バリエーションの商品は最初の行のみ入力し、以降の行は空白にできます。
|
| SKU在庫ポリシー(任意) |
バリエーションのオーバーセリングルール |
- 列は保持する必要がありますが、値は空白のままにできます。
- オーバーセリングを許可するには「continue」、防止するには「deny」を入力してください。
- 空白の場合、デフォルト値は「deny」になります。
- 無効な値は「deny」として扱われます。
- 複数バリエーションの商品は各SKU行にこのフィールドを入力してください。
|
| SKU 在庫数量(任意) |
バリエーションの在庫数量 |
- 列は保持する必要がありますが、値は空白のままにできます。
- 整数のみサポートされています。
- 値は-999,999,999から999,999,999の範囲内でなければなりません。
- 数値以外の値は0に変換されます。
-
このフィールドは複数の在庫ロケーションが有効になっている場合は効果がありません。複数ロケーションの在庫を一括で更新するには、一括在庫更新機能を使用してください。詳細な手順については "CSVファイルを使った在庫の一括更新。"を参照してください。
- 上書き更新時、このフィールドを空白のままにすると既存の在庫が保持されます。「空白フィールドを無視」設定が無効の場合、空白にすると値は0にリセットされます。
|
| 単価(任意) |
単位あたりの原価 |
- 列は保持する必要がありますが、値は空白のままにできます。
- 通貨記号なしで数字のみを入力してください。
- 小数点以下2桁までサポートされています。
- 11桁を超える値は11桁に切り捨てられます(最大値:99999999999)。
- バリエーションのない商品は最初の行のみ入力し、複数バリエーションがある商品は各SKU行に入力してください。
|
| バーコード(ISBN、UPC、GTINなど)(任意) |
物流および在庫追跡用のバーコード |
- 列は保持する必要がありますが、値は空白のままにできます。
- 最大長は255文字です。
- 衝突を避けるため、一意性を確保することを推奨します。
- 複数バリエーションがある商品は各SKU行に入力してください。
|
| SKU 税ポリシー(任意) |
バリエーションが課税対象かどうか |
- 列は保持する必要がありますが、値は空白のままにできます。
- 課税対象の場合は「T」、非課税の場合は「F」を入力してください。
- 空白の場合、デフォルト値は「T」になります。
- 無効な値は「T」として扱われます。
- ローカルインポートの場合はトグルルールに従います。その他のインポート方法では値は「Y」に設定されます。
|
| SKU配送ポリシー(任意) |
バリエーションが配送を必要とするかどうか |
- 列は保持する必要がありますが、値は空白のままにできます。
- 配送が必要な場合は「T」、不要な場合は「F」を入力してください。
- 空白の場合、デフォルト値は「T」になります。
- 無効な値は「T」として扱われます。
- ローカルインポートの場合、値はトグルルールに従います。その他のインポート方法では、値は「Y」に設定されます。
|
| パス(任意) |
カスタム商品ページのURLパス(相対) |
- 列は保持する必要がありますが、値は空白のままにできます。
- ドメインを含まない相対パスのみを入力してください。
- パスは最大5階層、最大長さ512文字まで可能です。
- 予約済みのシステムプレフィックスは使用できません。
- 無効な値は商品インポートを妨げませんが、URLの更新に失敗する可能性があります。
|
注意事項:
- 予約済みのシステムプレフィックスは使用できません。"/collections" または "/products" で始まるパスはサポートされていません。
- この機能を使用するには、カスタムURL設定を有効にする必要があります。
|
|
| ギフトカード(任意) |
商品がギフトカードかどうか |
- 列は保持する必要がありますが、値は空白のままにできます。
- はいの場合は「T」、いいえの場合は「F」を入力してください。
- 空白の場合、デフォルト値は「F」になります。
- 無効な値は「T」として扱われます。
- 複数のバリエーションがある商品では、最初の行のみ入力し、以降の行は空白にできます。
- ローカルインポートの場合、値はトグルルールに従います。その他のインポート方法では、値は「N」に設定されます。
|
| HSコード(任意) |
税関申告用のHSコード |
- 列は保持する必要がありますが、値は空白のままにできます。
- 値は6~12桁の数字でなければなりません。無効な形式の場合、インポートに失敗します。
- 複数のバリエーションがある商品では、このフィールドは各SKU行に入力してください。
|
| 発送元(任意) |
発送元の国/地域コード |
- 列は保持する必要がありますが、値は空白のままにできます。
- 値は有効な国または地域コードでなければなりません。無効なコードの場合、インポートに失敗します。
- 複数のバリエーションがある商品では、このフィールドは各SKU行に入力してください。
|
| 含まれる / マーケット(エクスポートのみ) |
商品が特定のマーケットに公開されているかどうか |
- 列は保持する必要がありますが、値は空白のままにできます。
- 商品をマーケットに公開するには「TRUE」と入力し、非公開にするには「FALSE」と入力してください。
- この列はデフォルトのインポートテンプレートには含まれていません。エクスポートされた商品ファイルでのみ利用可能です。
- 各マーケットは別々の列に対応しています(例:含まれる / アメリカ合衆国)。
|
| 販売価格 / マーケット(エクスポートのみ) |
特定のマーケットにおけるSKUの販売価格 |
- 列は保持する必要がありますが、値は空白のままにできます。
- 通貨記号なしで数字のみを入力してください(例:9.99)。
- 通貨はストアで設定されたマーケット通貨に従います。
- バリエーションのない商品は最初の行のみ記入し、複数のバリエーションがある商品は各SKUの行に記入してください。
- この列はデフォルトのインポートテンプレートには含まれていません。エクスポートされた商品ファイルでのみ利用可能です。
- 各マーケットは別々の列に対応しています(例:販売価格 / ヨーロッパ)。
|
| メタフィールド説明(エクスポートのみ) |
商品メタフィールドの値 |
- フィールド構造はストアで設定されたメタフィールド定義に依存します。
- 値はメタフィールドに定義されたデータ型(例:テキスト、数値、URL、ブール値)と一致している必要があります。
- 無効な値はインポート失敗の原因となるか、無視される場合があります。
|