スプレッドシートで商品をインポート・更新する#

カテゴリー別のテンプレートをダウンロードし、商品情報を入力してカタログにアップロードします。コードの記述や API 認証情報は必要ありません。

始める前に#

ダッシュボードで正しいストアを選択してください。カタログの編集権限が必要です。製品スプレッドシートをアップロードボタンが表示されない場合は、選択中のストア、カタログへの書き込み権限、アカウントが読み取り専用になっていないかを確認してください。

カテゴリー別テンプレートをダウンロードする#

1. ダッシュボード → カタログを開きます。
2. 製品スプレッドシートをアップロードをクリックし、製品をインポートするダイアログを開きます。
3. 商品カテゴリーを選択で、インポートするカテゴリーを選びます。選択肢はストアの設定によって異なります。
4. Excelテンプレートをダウンロードをクリックします。カテゴリーごとに別のテンプレートを使用し、個別にアップロードしてください。

新しいインポートを準備するときは、現在のカテゴリー要件に列が合うように、最新のテンプレートをダウンロードしてください。ダウンロードするブックはテンプレートであり、既存のカタログを書き出したものではありません。

ブックに入力する#

ブック内の各ワークシートは次のように使用します。

各商品行には sku、name、image_url、product_url に加え、カテゴリーごとの必須寸法が必要です。ダウンロードしたテンプレートの必須フィールド表示と説明に従ってください。フィールド名を翻訳したり、不明な列や重複する列を追加したりしないでください。

• SKU のセルは文字列形式にし、表計算ソフトによって先頭のゼロが削除されたり、長い識別子が変換されたりしないようにしてください。SKU ごとに一行を使用します。同じファイル内の重複値は、大文字と小文字だけが異なる場合も含めて拒否されます。
• image_url には、一般公開された HTTP または HTTPS の画像への直接 URL を指定してください。ログイン、Cookie、独自のリクエストヘッダーなしでアクセスできる必要があります。product_url には商品詳細ページの URL を入力します。
• 寸法と単位はテンプレートの説明に従って指定してください。寸法にも dimension_unit にも単位が指定されていない場合、既定値は in です。
• status には Enums に記載された値を指定します。空欄の場合は active になります。商品を更新するときは明示的に指定してください。

.xlsx 形式で保存することを推奨します。商品フィールドのヘッダー行とデータのみを含む場合は .csv も使用できます。旧形式の .xls ファイルには対応していません。各ファイルには空でない商品行を最大 50,000 行まで含めることができ、サイズは 50 MB 以下である必要があります。

アップロードして結果を確認する#

1. インポートダイアログに戻り、テンプレートと同じカテゴリーを選択します。
2. 完了してアップロードで保存したファイルを選び、インポートを開始をクリックします。
3. 最近のインポートで、ファイル名、処理状況、成功・失敗した行数を確認します。送信時に確認できるのは受付完了であり、処理はバックグラウンドで続きます。
4. 処理の完了を待ち、ジョブが完了と表示されても失敗した行がないか確認してください。カタログに戻り、インポートした商品データと準備状況を確認します。

失敗した行がある場合は、失敗ファイルをクリックしてエラーメッセージを確認し、商品データを修正して同じカテゴリーでファイルを再アップロードしてください。ダウンロードした失敗ファイルのブックには、失敗した行と診断用の列が含まれます。診断用の列は再アップロード時には無視されます。

一時的な処理エラーの場合は、再試行が表示されていれば使用してください。同じジョブを再試行しても、無効な商品データは修正されません。画面にサポートによる行の確認が必要と表示された場合は、Contact supportを使用してください。それらの行は自動的には再試行されません。

既存の商品を更新する#

商品を更新するには、同じカテゴリーのテンプレートを使用し、各商品の既存の SKU を保持してください。ファイルに含める各行の必須フィールドをすべて入力し、更新する値を変更して、ファイルを再アップロードします。

• 同じストアに同じ SKU がある場合は既存の商品を更新します。まだ存在しない SKU の場合は新しい商品を作成します。スプレッドシートで SKU を変更しても、元の商品の識別子は変更されません。
• 更新する商品の行だけをアップロードできます。ファイルに含まれない商品が削除、無効化、公開停止されることはありません。
• これは一部のフィールドだけを更新する処理ではありません。必須フィールドには引き続き値が必要です。任意のセルを空欄にすると以前の値が保持されるとは限りません。特に、status が空欄の場合は active、寸法の単位がない場合は in になります。
• 今後の更新に備え、入力済みのブックを手元に保存してください。ダウンロードするテンプレートには現在の商品データは含まれません。

ジョブの完了後、カタログで対象の商品を確認してください。インポートの成功だけでは、オンラインストアで表示されることは確認できません。商品の準備状況と SDK 公開前チェックリストを確認してください。

インポートを自動化する#

サーバー側で定期的に同期する場合は、Product Import API を使用してください。リクエストのフィールド、上限、一部のフィールドを更新する際の動作は、このスプレッドシートによる手順とは別に記載されています。