サブ画像一括登録・修正 – オンラインマニュアル

設定画面：商品管理 / 商品一覧 / CSV一括処理 / サブ画像一括登録・修正

ギガプラス10/100MBサーバーまたは外部Webサーバーにアップロードした画像ファイルを、CSV形式のファイルを用いてサブ画像として一括で登録・差し替え・削除できます。CSVファイルの文字コードは自動で判別します。

【重要】旧画面（複数商品画像一括登録/修正）をご利用だった方へ
サブ画像の列（6～55列目）の読み取り方が変わりました。旧画面で出力したCSVをそのままアップロードすると、意図しない画像が削除・差し替えされるおそれがあります。
必ずこの画面のサブ画像のダウンロードで出力したCSVを編集してご利用ください。
詳しくは画像列の読み取り順の変更についてをご覧ください。

【STEP1】画像ファイルを準備

あらかじめサブ画像用の画像ファイルを準備します。
登録できる画像の形式はPNG・JPEG・WebPです（GIF形式は登録できません）。
1商品あたり最大50枚まで登録できます。

▼画像ファイルの入ったフォルダ

【STEP2】画像ファイルをアップロード（100MBサーバー/ギガプラス10を使用）

画像ファイルを100MBサーバー/ギガプラス10または外部Webサーバーにアップロードします。
画像ファイルはお好きな場所にアップしていただけます。

▼アップロード画面イメージ

「http://」または「https://」から始まるURLを指定することで、外部Webサーバーから画像ファイルを取得することもできます。
外部のWebサーバーを利用される場合は公開領域にアップロードしてください。FTPサーバーからのファイルの取得はできません。

【STEP3】サブ画像一括登録CSVファイルの作成

登録済みの商品の画像ファイルの場所をCSVファイルで作成します。
更新しない商品は画像列を空欄にするか、行を削除すると変更されません。
CSVファイルは、サブ画像のダウンロードで現在の登録内容を出力し、それを編集して作成することをおすすめします。

CSVファイルとは？
CSVファイルとは「,（カンマ）」にて項目が区切られた形式のデータファイルです。
Excel（エクセル）を使ってデータ作成を行い、「ファイル」→「名前をつけて保存」→「ファイルの種類」にて"CSV（カンマ区切り）(*.csv)"を選択し保存することで簡単に作ることができます。

CSVファイルの項目数は全部で55個です。
先頭より、商品特定コード指定、システム商品コード、独自商品コード、基本カテゴリーパス、商品名、サブ画像１～５０としてください。
列の位置でデータを読み取るため、列の順番を入れ替えたり、不要な列を削除したりすることはできません。
（各項目の詳細はデータ項目一覧をご覧ください）

※一度に登録できるデータ件数に制限はありませんが、アップロードファイルの最大サイズは14MBまでとさせていただいております。超える場合はファイルを分割してください。
※1行目（見出し行）は読み飛ばします。旧画面で出力した「複数商品画像1～50」の見出しのCSVもそのままアップロードできますが、画像列の読み取り方が変わっているためご注意ください（画像列の読み取り順の変更についてをご覧ください）。

文字コードについて
アップロードするCSVファイルの文字コードは自動で判別します。指定は不要です。

▼対応している文字コード
Shift-JIS（S-JIS）/ UTF-8 / UTF-8（BOM付き）

CSVファイル内の特殊文字の取り扱いについて
データ中に以下の文字(記号)がある場合、その項目は必ず「"(ダブルクォーテーション)」にて囲むようにしてください。（データを囲んでいる「"」は反映されません）
なお、Excel（エクセル）を使ってデータを作成した場合、自動で処理されていますので記号などを考慮する必要はありません。

・「,」（カンマ）
・改行
・「"」(ダブルクォーテーション)※

※「"」（ダブルクォーテーション）がひとつの場合は「"」を重ねて入力し、文字列を囲っている場合は「"」を重ねた上でさらに文字列を「"」で囲んでください。

▼入力例

文字（記号）	修正前	修正後
,（カンマ）	1，2，3	"1，2，3"
改行	あいうえおかきくけこ	"あいうえおかきくけこ"
"(ダブルクォーテーション)	1"2	1""2
"(ダブルクォーテーション)	"さしすせそ"	"""さしすせそ"""

商品データを上書きするときは、商品を特定する項目（キーにする項目）を「システム商品コード」または「独自商品コード」からご指定いただけます。指定は、CSVデータの1項目目の「商品特定コード指定」に指定コードを入れることでおこないます。
（詳細は商品特定コードの指定をご覧ください）

サブ画像の列（6～55列目）には、以下の値を記載できます。

書き方	動作
空欄	その位置の画像を変更しません。
登録済み	その位置の画像を変更しません。（ダウンロードしたCSVに入っている値です）
削除 / NULL / null	その位置の画像を削除します。 ※「削除」は前後に空白があると削除として扱われません。空白なしで記載してください。 ※「Null」のように大文字・小文字が混在した書き方では削除できません。
画像のURL	その位置に画像を登録します。 ※すでに画像が登録されている位置を差し替える場合は、アップロード時に「画像が登録済みの場合は上書きする」にチェックを入れてください（STEP4参照）。

画像列の読み取り順の変更について

【重要】旧画面で出力したCSVは、そのまま使わないでください
サブ画像の列は、旧画面の「画像番号」順ではなく、商品編集画面に並んでいる表示順で読み取るように変わりました。
旧画面のCSVをそのままアップロードすると、意図した位置と違う画像が削除・差し替えされるおそれがあります。
必ず、この画面のサブ画像のダウンロードで出力したCSVを編集してご利用ください。

▼旧画面との違い

項目	旧画面（複数商品画像一括登録/修正）	この画面（サブ画像一括登録・修正）
画像列の並び	画像番号の順（画像を登録したときに決まる番号。並べ替えても変わりません）	商品編集画面の表示順
6列目（サブ画像１）	画像番号1の画像	表示順で1番目の画像
7列目（サブ画像２）	画像番号2の画像	表示順で2番目の画像
ダウンロードしたCSVの「登録済み」	画像番号の位置に入る（間の列が空欄になることがあります）	登録されている枚数ぶん、左から詰めて入る
CSVの見出し	複数商品画像1～50	サブ画像１～５０

▼例：サブ画像が3枚（画像番号3・17・50）登録されている商品の場合

	旧画面	この画面
「登録済み」が入る列	8列目・22列目・55列目	6列目・7列目・8列目
8列目に「削除」と記載した場合	画像番号3の画像が削除される	表示順で3番目の画像（画像番号50）が削除される

※この画面でダウンロードしたCSVをそのまま編集してアップロードする場合は、この違いを意識する必要はありません。
※見出しが「複数商品画像1～50」になっているCSVは、旧画面で出力したものです。お手元に残っている場合は使用せず、あらためてダウンロードしてください。
※画像列の並びは現在の表示順を示すものです。CSVの列を入れ替えて表示順を並べ替えることはできません。

【STEP4】サブ画像一括登録CSVファイルを使った一括登録

【STEP3】で作成いただいたCSVファイルをサブ画像一括登録・修正の画面からアップロードしていただくと、サブ画像が一括で登録・修正されます。

画面への行き方：
「商品管理」→「商品一覧」→「CSV一括処理」→「サブ画像一括登録・修正」カード内の「アップロード」をクリックします。

設定項目

画像登録オプション
「画像が登録済みの場合は上書きする」にチェックを入れると、すでに画像がある位置にURLを記載したとき、画像を差し替えます。チェックを入れない場合、その列は変更されません（エラーにはなりません）。
完了お知らせメール
取り込み完了をお知らせするメールの宛先を入力します。前回入力したアドレスが初期表示されます。空欄のままでも構いません。

「画像が登録済みの場合は上書きする」は、画面を開き直すたびにチェックが外れます。差し替えを含むCSVをアップロードする場合は、毎回チェックを確認してください。

操作手順

「画像が登録済みの場合は上書きする」を必要に応じてチェックします。
「完了お知らせメール」を必要に応じて入力します。
CSVファイルを選択します（ドラッグ＆ドロップ、またはファイル選択）。
選択と同時に書式チェックが実行され、エラーがある場合は一覧で表示されます。
「アップロード」ボタンをクリックします。
「アップロードが完了しました」の画面に切り替わります。

※書式エラーが1件でもあるとアップロードできません。エラーをすべて修正してから、ファイルを選択し直してください。
一部の商品だけを先に登録したい場合は、エラーの行を削除してからアップロードしてください。
※同じ商品を指定した行が複数ある場合（商品コードの重複）は、ファイル全体が受け付けられません。
※エラーの内容はエラーメッセージ一覧をご覧ください。
※登録または修正が反映されるまでには時間がかかります。

【STEP5】サブ画像一括登録状態の確認

サブ画像一括登録の進行状況と結果は「アップロード一覧」で確認できます。

アップロード完了画面の「CSV処理ジョブを確認」をクリックします。あとから確認する場合は、「CSV一括処理」の画面から「アップロード一覧」を開きます。
一覧で対象の行の進捗（処理待ち / 処理中 / 完了 / 失敗 / キャンセル）と、成功件数・失敗件数を確認します。タイプ列には「サブ画像」と表示されます。
エラーがある場合は行をクリックすると、何行目にどのようなエラーが発生したかを確認できます。

※アップロードの履歴は120日間保持されます。
※「完了お知らせメール」を入力していた場合は、件名「サブ画像一括登録・修正結果のお知らせ」のメールが届きます。
※画像を差し替えても、以前の画像が表示される場合があります。その場合は、ブラウザの再読み込み（キャッシュの削除）をお試しください。

サブ画像のダウンロード

現在登録されているサブ画像の状態をCSVファイルでダウンロードできます。
「CSV一括処理」の「サブ画像一括登録・修正」カード内の「ダウンロード」をクリックすると、ダウンロード画面が開きます。

カテゴリ
出力する商品を絞り込みます。「すべての商品」「カテゴリ未設定」と、登録されているカテゴリーから選択できます。どの階層のカテゴリーでも選択でき、選んだカテゴリーの配下にある商品がすべて対象になります。初期値は「すべての商品」です。
文字コード
Shift-JIS / UTF-8 から選択します。UTF-8はBOM付きで出力されるため、Excelでそのまま開いても文字化けしません。初期値はShift-JISで、前回選択したものが次回も初期表示されます。

※ファイル名は「sub_image_（出力日時）.csv」です。
※1商品につき1行で出力されます。基本カテゴリーを複数設定している商品も1行にまとまります。
※画像列には、登録されている枚数ぶんの「登録済み」が左から詰めて出力されます。
※「商品特定コード指定」は常に「0」（システム商品コード）で出力されます。
※対象が1000件を超える場合などは、ダウンロードの予約となります。「ダウンロードを受け付けました。」と表示されたら、「ダウンロードページへ」からダウンロード一覧に移動し、準備ができたファイルを取得してください。

データ項目一覧

列番号	Excel上の列記号	名称	必須	入力形式	詳細
1	A	商品特定コード指定	○	半角数字	商品データを上書きする際の商品を特定する項目（キーにする項目）を指定します。指定方法は以下のルールに沿って半角数字で指定を行います。 0＝システム商品コード 1＝独自商品コード
2	B	システム商品コード	△	半角数字	システム商品コードを指定します。商品特定コード指定=0のとき、その対象データを上書きします。一致するデータがない場合は、エラーメッセージが出力されます。 12桁より短い場合は、先頭を0で埋めて12桁として扱います（Excelなどで先頭の0が消えてしまっても取り込めます）。最大12文字
3	C	独自商品コード	△		独自商品コードを指定します。商品特定コード指定=1のとき、その対象データを上書きします。一致するデータがない場合は、エラーメッセージが出力されます。最大50文字
4	D	基本カテゴリーパス			参考情報のため、入力値は更新には利用されません。最大255文字
5	E	商品名			参考情報のため、入力値は更新には利用されません。最大255文字
6	F	サブ画像１		半角英数	URLで画像ファイルを指定します。 PNG・JPEG・WebP形式の画像を指定してください（GIF形式は登録できません）。 ■外部の画像でURLを指定して登録する場合例) https://*.test.jp/img/.jpg ※長辺が5000ピクセルを超える画像はエラーになります。 ※5000ピクセル以下の画像は、「長辺1600ピクセル以下」かつ「300KB以下」に収まるよう自動で縮小・圧縮して登録されます。元のサイズのままでは登録されず、1600ピクセルより小さくなる場合があります。既に登録されているサブ画像を削除する場合、「削除」「NULL」「null」のいずれかを記載すると削除できます。画像を登録後、CSVをダウンロードすると「登録済み」と表示されます。* 「登録済み」という文言はアップロード時に無視され、画像は変更されません。最大255文字
7	G	サブ画像２		半角英数	同上
8～54	H～BB	サブ画像３～４９		半角英数	同上
55	BC	サブ画像５０		半角英数	同上

※文字数は全角・半角の区別なく、すべて文字数で数えます。

商品特定コードの指定

商品特定コード指定	特定する項目	説明
0	システム商品コード	商品の登録/修正画面で確認するか、サブ画像のダウンロードでデータを出力してご確認ください。
1	独自商品コード	任意に設定できるコードです。他の商品と重複しないようにご登録いただかないと正しく上書きできません。

エラーメッセージ一覧

ファイル選択時（書式チェック）のエラー

ファイルを選択した時点で表示されます。エラーが1件でもあるとアップロードできません。

メッセージ	原因
（N列目）値が未入力です。	必須の列が空欄です。
（N列目）数値ではありません。	半角数字のみの列に、数字以外が入っています。
（N列目）値が不正です。	「商品特定コード指定」が0でも1でもありません。
（N列目）文字列が長すぎます。(N文字以内)	最大文字数を超えています。
項目数が一致しません。項目数を確認してください。	その行の列数が55ではありません。
画像指定ファイルの形式が違います。	1行目（見出し行）の列数が55ではありません。ファイル全体が受け付けられません。
以下の商品コードが重複しています。	同じ商品コードを指定した行が複数あります。ファイル全体が受け付けられず、1行も取り込まれません。

※1行につき表示されるエラーは1件のみです。同じ行に複数の誤りがある場合は、いちばん左の列のエラーだけが表示されます。修正してファイルを選択し直すと、次のエラーが表示されます。
※明細行の途中にある空行は読み飛ばします。

取り込み時のエラー

以下のエラーはファイル選択時の書式チェックでは表示されず、取り込みを実行した後にアップロード一覧で確認できます。

メッセージ	原因
商品が存在しません / 商品が見つかりません	指定したコードの商品が見つかりません。
独自コード「〜」の商品は複数存在します。システム商品コードで商品を指定してください。	独自商品コードで指定しましたが、そのコードの商品が複数あります。
複数商品が存在します	指定したコードに該当する商品が複数あります。
同じ商品を指定した行が複数あります	システム商品コードと独自商品コードなど、異なるコードで同じ商品を指定した行が複数あります。その商品の画像は1枚も変更されません（他の商品の行は取り込まれます）。
画像のURLが不正です	URLとして読み取れない値が記載されています。
画像の取得に失敗しました	URLにアクセスできない、または取得先から拒否されました。
画像提供元からの応答がありませんでした	取得先から応答がありません。
〜はサポートされていません	PNG・JPEG・WebP以外の形式の画像です（GIF形式は登録できません）。
0バイトの画像データです	取得したファイルが空です。
画像サイズが規定値を超過しています	画像の長辺が5000ピクセルを超えています。
削除する画像が登録されていません	「削除」を記載した位置に画像が登録されていません。
画像保存容量が不足しています	画像の保存容量が不足しています。その商品は削除も含めて1枚も変更されません。
画像の保存に失敗しました	画像の保存中に問題が発生しました。
画像の登録に失敗しました	画像の登録の確定中に問題が発生しました。
画像の削除に失敗しました	画像の削除の確定中に問題が発生しました。