JSON を CSV に変換

JSON を CSV に変換する方法

1. JSON を貼るか置く. 貼り付けたレスポンス、.json ファイル、1 行 1 オブジェクトの NDJSON のどれでも読めます。どこにも送信しません。
2. どの配列を読んだか確かめる. 包まれたレスポンスなら、使ったキー名(data・results・items など)が表の上に出ます。
3. 列を確かめる. 入れ子の値は 顧客.氏名 のようなドット区切りの列になり、文字列の配列は「; 」でつないだ 1 セルになります。
4. ダウンロードする. スクリプトやデータベースに渡すなら CSV、Excel で開くなら .xlsx を選びます。

JSON がきれいに CSV にならない 3 つの理由

CSV は長方形です。列が決まっていて、1 レコードが 1 行。JSON は木です。変換の失敗はほとんどがこの違いから来ていて、どれも 1 行目を書く前に決まります。

• レコードが一番外にない。 API は {"data": [ … ]} や {"results": [ … ]} のように、行を 1 段下に入れて返します。 外側の包みをそのまま変換すると、横に長い 1 行ができるだけです。このページは一番外のキーの中から「オブジェクトが入った最初の配列」を探し、どのキーを使ったかを表の上に表示します。
• 値が入れ子になっている。 {"顧客": {"氏名": "山田", "県": "東京"}} は 顧客.氏名 と 顧客.県 の 2 列になります。 [object Object] と書かれた 1 セルにはなりません。オブジェクトの配列は 明細.0.品番 のように番号付きの列に展開します。
• レコードごとに項目が違う。 3 件目にだけ タグ がある、というのはよくあることです。列は全レコードのキーの和集合で、最初に出てきた順に並びます。 無い値は空のセルになるので、値が左にずれて別の列に入ることはありません。

日本語版 Excel で開く前に:CSV は BOM なしの UTF-8 です

このページの CSV ダウンロードは UTF-8(BOM なし)で書き出します。スクリプトやデータベース、Google スプレッドシートにはそれで問題ありません。

ただし日本語版の Excel は、BOM の無い CSV をダブルクリックで開くと Shift-JIS(CP932)と見なすことがあり、日本語の列名や値が化けます。 このページは Shift-JIS での書き出しも BOM の付与もしていません。Excel で開くなら、隣の .xlsx をダウンロードを使ってください。.xlsx には文字コードの問題がありません。 CSV のまま開きたいときは、Excel の「データ」→「テキストまたは CSV から」で読み込み、元のファイルの文字コードに「65001: Unicode (UTF-8)」を選びます。 すでに化けて保存してしまった CSV は CSV の文字化けを直すで読み直せます。

長い番号は「文字列」で入っていれば守られます

"伝票番号": "000123456789012345" のように引用符で囲まれた値は、文字のまま CSV に出ます。先頭のゼロも 18 桁もそのままです。 一方、"id": 123456789012345678 のように数値で書かれた 16 桁以上の番号は、ブラウザが JSON を読んだ時点で末尾が丸められます。これはこのページに限らず JavaScript で JSON を読むツール全般の制約です。

NDJSON と壊れた JSON

ログや BigQuery の書き出しは、1 行に 1 つの JSON が並ぶ NDJSON であることが多く、ファイル全体としては正しい JSON ではありません。 全体として解析できなかったときは 1 行ずつ解析し直し、それで読めれば表の上に「NDJSON」と表示します。 どちらでも読めない場合は、末尾のカンマ、シングルクォート、文字列の中の改行など、パーサーが止まった理由をそのまま表示します。

毎週同じ API を同じシートに落としているなら

最初の 2〜3 回はブラウザのタブで十分です。同じエンドポイントを決まった周期で同じシートに入れ、項目が消えたら誰かが気づく必要がある —— そこから先は変換ではなく仕組みの話です。 TableDI 2 は、毎期やり直すファイル作業のためのデスクトップアプリです。ソース・ルール・納品のしかたをジョブとして保存するので、来月は新しいファイルを入れてもう一度実行するだけ。すべてあなた自身のパソコンの中で動きます。