| フィールド名 |
説明 |
ルール / 注: |
| 商品ID(エクスポートのみ) |
各商品に対してシステムが生成する一意のIDで、マーチャントがproduct_idを取得するために使用します |
- インポート時に入力された値はすべて無視されます。
- 最大長は64文字です。
|
| バリエーションID(エクスポートのみ) |
各バリエーションに対してシステムが生成する一意のIDで、更新時に既存のバリエーションを識別するために使用します |
|
| Handle(任意) |
商品タイトルから生成される一意の商品識別子で、インポート時に商品を照合するための主要な識別子として使用されます |
- 列は保持する必要がありますが、値は空白でも構いません。
- 更新時は既存のHandleと完全に一致している必要があります。そうでない場合は新しい商品として扱われます。
- 一致が見つかれば商品は更新されます。
- 見つからなければ新しい商品が作成されます。
- 複数のバリエーションがある商品の場合、最初の行のみ入力し、以降の行は空白にできます。
- スペースや特殊文字は自動的に「-」に変換されます(例:「apple phone」→「apple-phone」)。
|
注:Handleが既存の商品と一致する場合、このフィールドは更新時に上書きされませんが、その他の関連情報はすべて更新されます。具体的な動作はインポート時に同じHandleの商品を上書きするが選択されているかどうかによります:
- 選択されている場合、一致するHandleの既存商品が上書きされます。
- 選択されていない場合、SHOPLINEは重複するHandleに数値のサフィックスを自動で付加し、一意のHandleを作成して新しい商品としてインポートします。
|
|
| タイトル(必須) |
商品名またはタイトル |
- この列は保持する必要があり、値を空にすることはできません。
- 最大長は255文字です。これを超えるとインポートに失敗します。
- 複数のバリエーションがある商品は、最初の行のみ入力し、以降の行は空白のままでかまいません。
- このフィールドは「空白フィールドを無視」設定の影響を受けません。空白のままだとインポートに失敗します。
|
| サブタイトル(任意) |
商品サブタイトルまたはキャッチフレーズ |
- この列は保持する必要がありますが、値は空白でもかまいません。
- 最大長は400文字です。超過した内容は自動的に切り捨てられます。
- 複数のバリエーションがある商品は、最初の行のみ入力し、以降の行は空白のままでかまいません。
|
| 商品説明html(任意) |
詳細な商品説明 |
- この列は保持する必要がありますが、値は空白でもかまいません。
- プレーンテキストとHTMLの両方に対応しています。
- 改行や太字などの書式を適用するにはHTMLコードが必要です。
- プレーンテキストの場合は、追加のスタイルなしで直接内容を入力してください。
- 複数のバリエーションがある商品は、最初の行のみ入力し、以降の行は空白のままでかまいません。
|
| SPU(任意) |
マーチャント定義の内部商品識別子 |
- この列は保持する必要がありますが、値は空白でもかまいません。
- 最大長は255文字です。これを超えるとインポートに失敗します。
- 絵文字はサポートされておらず、インポートに失敗します。
- 複数のバリエーションがある商品は、最初の行のみ入力し、以降の行は空白のままでかまいません。
|
| ブランド(任意) |
商品ブランドまたは製造元 |
- この列は保持する必要がありますが、値は空白でもかまいません。
- 最大長は255文字です。超過した内容は自動的に切り捨てられます。
- 複数のバリエーションがある商品は、最初の行のみ入力し、以降の行は空白のままでかまいません。
|
| タグ(任意) |
カテゴリ分けおよび検索フィルタリングに使用されるタグ |
- 列は保持する必要がありますが、値は空白のままにできます。
- 1行に複数のタグをカンマで区切って入力してください(例:red, summer)。
- タグは大文字・小文字を区別しません(ABC = abc)。
- 商品ごとに最大250個のタグが許可されており、それを超えるタグは無視されます。
- 複数のバリエーションがある商品では、最初の行のみ入力し、以降の行は空白のままにしてください。
|
| カテゴリ(任意) |
商品が属するカテゴリのハンドル |
- 列は保持する必要がありますが、値は空白のままにできます。
- カテゴリのハンドル(タイトルではなく)を使用し、スペースは「-」に変換してください。
- 複数のカテゴリハンドルはカンマで区切ってください。
- スマート分類はサポートされていません。
- 複数のバリエーションがある商品では、最初の行のみ入力し、以降の行は空白のままにしてください。
|
警告:この列をシートから削除すると、既存のカテゴリがクリアされる可能性があります。慎重に操作してください。 |
|
| マスター画像(任意) |
メイン商品の画像URL |
- 列は保持する必要がありますが、値は空白のままにできます。
- 1行につき1つの画像URLを入力してください。各商品は最大500枚の画像をサポートします。
- 対応フォーマットはJPG、JPEG、PNG、GIF、WebPです。
- 各画像のサイズは10MBを超えてはいけません。超えるとインポートに失敗します。
- 画像URLの最大長は512文字です。これを超えるとインポートに失敗します。
|
注:このフィールドを通じて画像URLをインポートすると、画像が既に存在していてもファイルライブラリに新しいコピーが常に作成されます。重複を避けるには、一括インポートではなく個別に商品を作成してください。 |
|
| 画像代替テキスト(任意) |
商品画像の代替テキスト(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文字です。
- 複数のバリエーションがある商品では、このフィールドは各行に入力する必要があります。
|
| オプション1名(任意) |
最初のバリエーション属性の名前(例:色) |
- 列は保持する必要がありますが、値は空白のままにできます。
- このフィールドは「空白フィールドを無視」設定の影響を受けません。CSVファイルを更新する際にこのフィールドの情報をクリアしないでください。クリアすると元のバリエーション値が削除されます。
- 商品は最大5つのオプション名を持つことができ、各名前の最大長は255文字です。
- 複数のバリエーションがある商品では、最初の行のみ入力し、以降の行は空白のままでかまいません。
|
警告: 更新時にこのフィールドをクリアすると、既存のバリエーション構造が削除される可能性があります。 |
|
| オプション1の値(任意、ただしオプション1の名前に値がある場合は必須) |
最初のバリアント属性の値 |
- 対応するオプション名が提供されている場合、このフィールドは必須になります。
- 列は保持する必要がありますが、値は空白のままにできます。
- このフィールドは「空白フィールドを無視」設定の影響を受けません。CSVファイルを更新する際、このフィールドの情報をクリアしないでください。クリアすると元のバリアント値が削除されます。
- 各セルには1つの値のみを含めてください。
- 重複する値(スペースをトリムした後)は許可されず、インポート失敗の原因となります。
- 値はバリアントの組み合わせに基づいて行ごとに入力してください(例:Red-S、Red-Mは別々の行に入力)。
|
警告:更新時にこのフィールドをクリアすると既存のバリアント値が削除される可能性があります。 |
|
| オプション2~オプション5の名前(任意) |
2番目から5番目のバリアント属性の名前 |
オプション1の名前と同じルールです。 |
| オプション2~オプション5の値(任意、ただし対応するオプション名に値がある場合は必須) |
2番目から5番目のバリアント属性の値 |
オプション1の値と同じルールです。 |
| オプション1の値の画像(任意) |
最初のバリアント値の画像URL |
- 列は保持する必要がありますが、値は空白のままにできます。
- 各オプション値は1つの画像のみをサポートします。
- 対応フォーマットはJPG、JPEG、PNG、GIF、WebPです。
- 各画像のサイズは10MBを超えてはいけません。
- URLの最大長は512文字です。これを超えるとインポートに失敗します。
|
注: マスター画像と同様に、このフィールドを通じて画像URLをインポートすると、既に存在していても必ずファイルライブラリに新しいコピーが作成されます。重複を避けるには、一括インポートではなく個別に商品を作成してください。 |
|
| オプション2~オプション5の値の画像(任意) |
2番目から5番目のバリアント値の画像URL |
オプション1の値の画像と同じルールです。 |
| 画像(任意) |
バリエーション(SKU)の画像URL |
- 列は保持する必要がありますが、値は空白のままにできます。
- 各SKUは1つの画像のみ対応しています。
- 対応フォーマットはJPG、JPEG、PNG、GIF、WebPです。
- 各画像のサイズは10MBを超えてはいけません。
- URLの最大長は512文字です。これを超えるとインポートに失敗します。
|
注: マスター画像と同様に、このフィールドを通じて画像URLをインポートすると、既に存在していても常にファイルライブラリに画像の新しいコピーが作成されます。重複を避けるには、一括インポートではなく個別に商品を作成してください。 |
|
| 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、ブール値)と一致している必要があります。
- 無効な値はインポート失敗の原因となるか、無視されることがあります。
|