ネストされたJSONからCSVへ：行と列を選択

JSONエクスポートにはリストの中にリストが含まれることがありますが、CSVは行と列が必要です。変換する前に、どのリストをテーブルにするか、各レコード内の値をどう扱うかを選択してください。

このサンプルJSONには、data.itemsの下に2つのクリエイターが含まれています。それぞれにネストされたcreatorオブジェクト、tags配列、noteフィールドがあります。1つのメモはnullで、もう1つは空文字列です。

列を選ぶ前にレコードを選択

CSV、JSON、YAMLコンバーターを開き、サンプルをインポートして、からでJSON、宛先でCSVを選択します。オプションを開き、データパス（オプション） に/data/itemsを設定します。

このパスがないと、外側のオブジェクトが1行になります。パスを設定すると、2つのアイテムが2行になります。パスはデータを選択するだけで、フィールド名の変更や値の検索は行いません。

パスはスラッシュ区切りの名前を使用し、JSON Pointer表記に従います。/data/itemsと入力してください。data.itemsはこの欄では使えません。フィールド名自体にスラッシュが含まれる場合は、そのスラッシュを~1と書き、リテラルのチルダには~0を使用します。

ネストされたオブジェクトを1つのセルに含めるかどうかを決定

ネストされたオブジェクトをフラット化をオフにすると、列はid、creator、tags、noteになります。クリエイターオブジェクトはJSONテキストとして1つのCSVセルに収まります。これは有効なCSVですが、国で並べ替えたい場合には扱いにくいです。

フラット化をオンにすると、列は次のようになります：

/id
/creator/name
/creator/region
/tags
/note

これで、ZoëとAUがそれぞれ独自のセルを持ちます。スラッシュ接頭辞付きのヘッダーは、各値がどこから来たかを示します。また、リテラルフィールド名creator.nameとネストされたフィールドnameの混同を防ぎます。

ネストセルCSVとフラット化CSVを比較してください。どちらも2つのデータ行があります。CSVセル内のJSONの周りの二重引用符はエスケープであり、データの重複ではありません。

配列は追加の行にはならない

フラット化はネストされたオブジェクトを展開します。配列を行に分割したり、配列の各エントリに別の列を作成したりはしません。この例では、/tagsは1つのセルに単一のJSON配列を含みます：

["design","video"]

スプレッドシートでタグごとに1行が必要な場合は、事前にそのテーブルを明示的に準備してください。各行でクリエイターのIDを繰り返すかどうか、空のタグリストをどう表現するかを決定します。コンバーターはこれらの決定を代わりに行いません。

後で再構築する必要がある場合はJSONを保持

CSVには、欠損値、null、空文字列の組み込みの区別がありません。このサンプルの両方のメモは空のセルとしてエクスポートされます。デフォルト設定でそのCSVをJSONに戻すと、2つの空文字列が生成されます。

変換後のJSONも、/creator/nameをリテラルキーとして、/tagsを文字列として保持します。ネストされたオブジェクトを再構築したり、配列を自動的に解析したりはしません。元のJSONを信頼できるソースとして保持してください。

ID 001はこのコンバーターではテキストとして保持されます。スプレッドシートでCSVを開くときに数値として解釈される可能性があるため、ID列もテキストとしてインポートしてください。スプレッドシート向けのエクスポートではスプレッドシートの数式からCSVを保護をオンにしたままにし、共有前にファイルを確認してください。

確認した内容

2026年10月8日に、ツールと同じ変換関数でサンプルを実行しました。両方のCSVバリアント、2行のカウント、5つのフラット化された列、JSONへの変換を確認しました。結果ファイルには出力とダウンロードハッシュが含まれています。

テーブルプレビューは最大500行を表示しますが、エクスポート全体の数ではありません。大規模なデータセットを扱う場合は、表示された合計とダウンロードしたファイルを確認してください。