開発者向け作業フロー

スプレッドシート用 CSV を JSON に変換する

スプレッドシート用 CSV を JSON に変換する手順をまとめた実践ガイドです。CSVJSON変換を使い、入力確認から結果の見直しまでブラウザ内で進めます。

課題

急いで作業すると、入力の範囲、エンコード、順序、機密情報、出力形式を見落としがちです。スプレッドシート用 CSV を JSON に変換するでは、CSVJSON変換を使ってローカルで確認しながら、共有前に問題を減らします。

使う場面

  • スプレッドシートのエクスポート結果を API リクエスト本文に貼り付ける必要があるときに使います。
  • 商品リストや顧客リストを JSON フィクスチャにしたい場合に適しています。
  • CSV ファイルを内部ツールへ取り込む前に、ヘッダーや空セルを確認したいときに役立ちます。
  • Excel、Google Sheets、地域設定から出た CSV の区切り文字と文字コードを変換前に確認したいときに使います。

手順

  1. 手順 1

    ヘッダー行を確認

    最初の行が JSON key にできる安定したフィールド名になっているか確認します。

  2. 手順 2

    CSV を JSON に変換

    CSV を貼り付け、各行が構造化された record になるようにオブジェクト配列へ変換します。

  3. 手順 3

    空セルと数字に見える値を確認

    空セルを空文字列、明示的な空値マーカー、削除されたフィールドのどれにするか決め、ID や郵便番号を文字列のままにすべきか確認します。

  4. 手順 4

    JSON 結果を整形

    テスト、例、API デバッグに使う前に JSON 出力を読みやすく整えます。

  5. 手順 5

    利用先 API や fixture と照合

    生成された key、必須フィールド、データ型、行数が実際のリクエスト本文やテスト fixture の規則と合っているか比較します。

スプレッドシート用 CSV を JSON に変換するの例

入力

id,email,plan
42,dev@example.com,pro
43,ops@example.com,starter

出力

[
  {
    "id": "42",
    "email": "dev@example.com",
    "plan": "pro"
  },
  {
    "id": "43",
    "email": "ops@example.com",
    "plan": "starter"
  }
]

よくあるミス

人間向けラベルを API key に使う

Customer Email のようなヘッダーは、fixture を作る前に customerEmail や email のような安定した key へ変えてください。

引用符内のカンマを無視する

住所、名前、説明にはカンマが含まれることがあります。変換では引用符で囲まれた CSV セルをむやみに分割しないことが重要です。

スプレッドシートの数式を確認せずに変換する

CSV エクスポートには、保存方法によって計算済みの値または数式文字列が含まれることがあります。JSON フィクスチャや API 例に変換する前に、数式列を確認してください。

CSV エクスポートの形式を確認しない

Excel、Google Sheets、地域設定によって区切り文字、引用符、改行、文字コードが変わることがあります。JSON 出力を判断する前に、入力ファイルの設定と合わせてください。

非公開のスプレッドシート列まで取り込む

エクスポートにはメモ、内部 ID、非表示列、一時的なレビュー項目が含まれることがあります。API や fixture に不要な列は変換前に削除してください。

よくある質問

CSV の数字は JSON number にするべきですか?

API の規則によります。ID、郵便番号、口座番号は先頭の 0 が意味を持つことがあるため、文字列のままにする方が安全な場合が多いです。

CSV がセミコロン区切りの場合はどうしますか?

一部のスプレッドシートエクスポートは locale 設定によりセミコロンを使います。変換前にファイルに合う区切り文字を選んでください。

CSV でネストした JSON を表せますか?

CSV は基本的に平坦な構造です。ネストした JSON は通常、基本変換後に別のマッピング規則や後処理が必要です。

重複した CSV ヘッダーはどう扱いますか?

変換前に重複ヘッダーを変更します。JSON オブジェクトは同じキーのフィールドを安定して保持できないため、billingEmail、shippingEmail のように明確な名前へ分けてください。

空のセルは JSON でどう表現すべきですか?

変換前に、空欄を空文字列、明示的な空値マーカー、省略されたフィールドのどれにするか決めてください。正しい選択は、その JSON を使う API やフィクスチャの規則によって変わります。

取り込み前に変換済み JSON をどう検証しますか?

JSON を使う前に、行数、必須 key、データ型、重複ヘッダー、スプレッドシートの先頭と末尾にある edge row をいくつか確認してください。