---
title: 商品をインポート
description: Runner の CSV テンプレートを使用してカタログインポートを開始し、その処理履歴を追跡します。
---

準備された CSV から商品をインポートします。同じ構造化されたカタログ情報を1つずつ手動で入力するのが非効率な場合に使用します。

## インポートを使用する理由と時期

スプレッドシートまたは別のシステムに既に商品データがあり、Runner の CSV テンプレートにマップできる場合は、インポートを使用します。小さなカタログの場合、または最初にフィールドを学ぶ必要がある場合は、手動の [商品](./products) フォームを使用します。

## 利用可能性と前提条件

- 準備ができたストアで **ストア運営 → 商品** を開きます。
- ライブストアフロントカタログチャネルを作成するストア公開/準備セットアップを完了します。インポートタスクはそのチャネルなしで続行できません。
- 入力されたデスクトップ商品リストは **インポート** を表示します。空のカタログでは、最初に **最初の商品を追加** を使用します。モバイルビューは手動作成を強調します。
- インポートは CSV ファイルのみを受け入れます。
- Runner の現在のテンプレートを使用します。必須列は `handle` と `title` です。バリアント行には、テンプレートで示されている必須 `sku` とオプション値を含める必要があります。
- インポートを開始するとストアカタログが変更されます。送信する前にファイルを確認してください。

## 商品をインポートを開く

**エントリパス:** **ワークスペース → ストアを選択 → ストア運営 → 商品 → インポート**

![商品をインポートダイアログ](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgObeFKMJCcW62zHrU8smjSnqvixd1twlAf4uK)

## メインコントロール

| コントロール | 使用する理由 | 選択時の動作 |
| --- | --- | --- |
| **インポート** | 一括インポートワークフローを開く | インポート商品ダイアログを開き、タスクを開始しません。 |
| **テンプレート** | Runner の予想される列から開始する | 現在の `product-import-template.csv` ファイルをダウンロードします。 |
| **履歴** | 以前のインポートタスクを確認する | インポートファイルとその最新の状態のリストに切り替えます。 |
| アップロード領域 | 準備された CSV を選択する | ファイルをローカルで読み込み、コンテンツが利用可能な場合は準備完了として表示します。 |
| ファイル削除コントロール | 間違った選択を修正する | 選択したファイルをクリアして、別のファイルを選択できるようにします。 |
| **インポートを開始** | 選択した CSV を送信する | インポートタスクを開始し、Runner がそれを受け入れたときに履歴に移動します。 |
| **キャンセル** | 送信せずに離脱する | ダイアログを閉じて、選択したファイルをクリアします。 |
| **更新** (履歴内) | 最新のタスク状態をリクエストする | 表示されているインポート履歴を再読み込みします。 |
| **インポートに戻る** | 別のファイルを準備する | 履歴からアップロードビューに戻ります。 |
| **閉じる** | 履歴を離脱する | 既に送信されたタスクを変更せずにダイアログを閉じます。 |

## CSV を準備して送信する

1. **インポート** を選択してから、**テンプレート** を選択します。
2. ダウンロードした CSV をスプレッドシートエディターで開き、CSV 形式を保持します。
3. テンプレートヘッダーを保持します。商品の `handle` と `title`、およびバリアントの表示された `sku` とオプション値を完成させます。
4. エクスポート前に、商品ハンドル、タイトル、価格、バリアント、および繰り返される行を確認します。
5. ダイアログに戻り、CSV をアップロード領域に選択またはドラッグします。
6. ファイルが **インポート準備完了** と表示されるまで待ちます。
7. **インポートを開始** を1回選択します。
8. **履歴** で、送信されたファイルが終了状態に達するまで追跡してから、商品リストを更新し、結果の行を検査します。

## 履歴状態を理解する

| 状態 | 意味 | 実行すること |
| --- | --- | --- |
| **保留中** | タスクは開始を待機しています | そのままにして後で再度確認します。すぐに重複を送信しないでください。 |
| **処理中** | Runner はファイルを処理しています | ダイアログを開いたままにするか、後で履歴に戻ります。 |
| **完了** | Runner はファイルをカタログインポーターに渡し終わりました | このステータス後も商品処理は続行できます。商品を更新し、名前、バリアント、価格、ステータス、および在庫を検査します。 |
| **失敗** | Runner はインポートタスクを完了できませんでした | 現在の履歴カードは失敗した状態を記録しますが、詳細な原因は記録しません。前提条件とソース CSV を確認してから、新しいファイルを送信してください。 |
| **キャンセル** | タスクは続行しませんでした | 次に何を送信するかを決定する前に、商品が作成されたかどうかを確認してください。 |

履歴は、Runner がこれらの値を持っている場合、ファイルサイズ、合計行数、およびトランザクション ID も表示できます。これらの詳細はタスクを識別します。商品レコードをチェックする代わりにはなりません。

## 制限とトラブルシューティング

- **インポートを開始が無効:** `.csv` ファイルを選択し、Runner が空でないコンテンツの読み込みを完了するまで待ちます。
- **無効なファイルタイプ:** スプレッドシートを CSV としてエクスポートします。別のファイル形式の名前を変更しても変換されません。
- **ファイル読み込みエラー:** CSV を再度エクスポートし、デバイスで正常に開くことを確認してから、もう一度選択します。
- **インポート失敗:** ストア公開/準備セットアップがライブストアフロントカタログチャネルを作成したことを確認し、提供されたテンプレートを使用し、必須列を復元し、バリアント `sku` とオプション値を確認します。
- **タスクが停止しているように見える:** 履歴を開き、**更新** を選択します。保留中と処理中は完了の証明ではありません。
- **予期しない商品行が表示される:** 同じインポートを盲目的に繰り返さないでください。CSV ハンドルを商品リストと比較し、意図的にレコードを修正してください。

## 関連ガイド

- [商品](./products)
- [在庫とバリアント](./inventory-and-variants)
- [オンボーディングと一般設定](./onboarding-and-general-settings)
- [ストア運営の概要](./)