商品フィードの必須列欠落と列ずれの解説
投入前CSV・TSVファイルで生じる構造エラーの原因と検査基準の技術解説
発生する事象
Google Merchant Center向けの商品データソースを手動または外部ツールから作成して登録する際、ヘッダー行やデータ行の構造の不整合により処理エラーが報告される事例があります。主な事象としては、必須と定義されているヘッダー列そのものの欠落、選択必須となるヘッダー群の不在、ヘッダーは存在するもののデータ行で必須値が空になっている状態、ヘッダーの列数とデータ行の列数が合致しない列ずれ、行末尾に余分な空列が付加されている状態、ヘッダー名の大文字小文字や前後空白による表記ゆれ、同一ヘッダー名の重複登録などが挙げられます。
原因と発生要因
これらの事象が生じる主な要因の一つは、商品データ管理の実務において表計算ソフトやECカートのCSVエクスポート機能を経由する点にあります。一般的な表計算ソフトでカンマ区切り(CSV)ファイルを編集・保存すると、引用符の扱いや改行、カンマを含むテキストフィールドの解釈差によって、意図しない列のずれや行の分割が発生することがあります。
Google公式の技術仕様ドキュメントにおいても、カンマは属性内の予約文字として扱われるためCSV形式は推奨されず、区切り文字としてタブを用いたTSV形式の利用が案内されています。しかし、日本語圏のカートシステムや業務フローでは依然としてCSV形式によるデータ編集が広く行われており、この形式差と編集手順のずれが投入前の不整合を生む構造的背景となっています。
確認すべき項目と実装済み検査仕様
フィード整備士では、以下の10項目の実装済み仕様ルールに基づき、ブラウザ内ローカル処理で決定的な構文検査を実施します。
- MISSING_REQUIRED_HEADER: 必須ヘッダー(id, link, price, availability, image_link)が存在するか検査します。
- MISSING_REQUIRED_HEADER_GROUP: 相互補完関係にある必須グループ(titleまたはstructured_title、descriptionまたはstructured_description)のいずれかが存在するか検査します。
- EMPTY_REQUIRED_VALUE: 必須ヘッダーに対応する各行のデータセルに空値がないかを検査します。
- EMPTY_REQUIRED_VALUE_GROUP: 必須グループ列において有効なデータ値が存在するかを検査します。
- COLUMN_COUNT_MISMATCH: ヘッダー行の項目数とデータ行のセル数が正確に一致しているか(列ずれの有無)を検査します。
- TRAILING_EMPTY_COLUMNS: データ行のセル数がヘッダー行の項目数より少ない場合に、safe fix適用時に不足する末尾の空セルを補完した変更ログです。エラー検出ルールではなく、補完適用時に元のセル数とヘッダー項目数が変更ログへ記録されます。セル数が不足する行は、安全修正を適用しない通常の診断ではCOLUMN_COUNT_MISMATCHとして検出します。安全修正を適用して末尾の空セルを補完できた行では、そのセル数不足によるCOLUMN_COUNT_MISMATCHが適用後の診断結果から解消します。この補完が解消するのは該当行のセル数不足による項目であり、セル数が多すぎる場合は補完の対象ではなく、他の値のエラーまで解消するとは限りません。画面の問題一覧は先頭100件までの表示です。検出した件数の合計はエラーと警告の件数表示でご確認ください。
- HEADER_CANONICAL_FORM: 安全修正を適用したときに、ヘッダー名を正規形へそろえた内容を記録する変更ログです。問題一覧に表示されるエラー検出ルールではありません。安全修正を適用しない通常の診断でも、検査に用いるヘッダー名には前後空白の除去と小文字化が適用されますが、この変更ログは作成されません。既知の別名表記を正準の名称へ置き換えるのは安全修正を適用したときで、その置き換えが変更ログへ記録されます。個々の変更前後の値は変更履歴ファイルのダウンロードでご確認いただけます。安全修正の適用に成功した後、ヘッダー以外の変更も含む安全修正全体の件数が画面の「適用した変更」と状態表示に出ます。
- DUPLICATE_HEADER: 同一名称のヘッダー列が2回以上出現していないかを検査します。
- VALUE_TOO_LONG: idは50文字、titleは150文字、descriptionは5000文字などの上限を超えていないかを検査します。長さはUnicodeのcode point数で数えます。titleとdescriptionは警告として報告します(Google側は超過分を切り詰めます)。
- DUPLICATE_ID_CASE_INSENSITIVE: ASCII英字の大文字小文字だけが異なるIDが複数行に現れていないかを検査し、警告として報告します(例: AB1とab1)。非ASCIIの文字による大文字小文字の差(例: Ä1とä1)はこのルールでは警告しません。文字通り同一の重複は既存のDUPLICATE_IDで報告します。
公式一次仕様リンク
データ仕様およびファイル作成の一次仕様については、以下のGoogle公式ヘルプドキュメントをご確認ください。