スプレッドシートの表を、ドライブにCSVで書き出す

GAS
目次

スプレッドシートの表を、ドライブにCSVで書き出す処理は、基幹システムへのデータ連携や他ツールへの受け渡しにおいて頻繁に求められる自動化処理の一つです。Google Apps Script（GAS）を利用すれば、標準のAPI群を組み合わせるだけでシート上のデータを迅速にファイル出力できます。しかし、処理の核となるコードだけをそのまま動かした場合、実際のデータに含まれる記号や表示形式の違いによって、出力結果のレイアウトが大きく崩れる事態が発生します。ここでは、実効性のある最小限の記述を出発点とし、実行時に発生する具体的な挙動のずれと、それを回避するための実務的な考え方を書き残しておきます。

スプレッドシートの表をドライブにCSVで書き出す基本コード

まずは、スプレッドシートの表を、ドライブにCSVで書き出す処理を行う最小限のスクリプトを提示します。このコードは、アクティブなシートの全データを取得し、カンマ区切りのテキストデータへ変換した上でGoogleドライブの直下にファイルとして保存します。

function exportSheetToCsv() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const csv = sheet.getDataRange().getValues().map(r => r.join(",")).join("\n");
  DriveApp.createFile("export.csv", csv, MimeType.CSV);
}

この記述は、スプレッドシート CSVで書き出すという目的を最速で達成したいときに役立ちます。`getDataRange().getValues()` を呼ぶことで、シート内で値が存在するセル範囲を自動判別し、2次元配列として全データを一元取得します。続いて、JavaScriptの配列操作メソッドである `map` と `join` を組み合わせ、各行の配列要素をカンマで繋ぎ、最後に行同士を改行コード `\n` で連結して1つのテキストブロックにまとめています。最後に `DriveApp.createFile` を呼び出すことで、ファイル名「export.csv」、指定した文字列本文、そしてMIMETYPE「MimeType.CSV」を持ったファイルがGoogleドライブ上に保存されます。

しかし、この最もシンプルなコードのまま実務の運用へ組み込むと、いくつかの重大な問題に突き当たります。一つは、取得した2次元配列の要素に「カンマ」や「改行」が含まれていた場合、CSVとしての列構造や行構造が意図せず分裂してしまう点です。もう一つは、日付データや数値データがスプレッドシートの画面で見えている表示通りの文字列ではなく、JavaScriptの内部オブジェクトや生の数値として処理されてしまう点です。さらに、出力先が指定されていないため、実行するたびに「マイドライブ」の直下に同名のファイルが量産されてしまう点も無視できません。実際の業務で運用する際は、これらのズレをあらかじめ予見し、コード側でエスケープや保存先の整理を行う必要があります。

getDataRange().getValues() によるデータ抽出と文字崩れの回避

先ほどのコードで使われている `getDataRange().getValues()` は、処理速度が速く、一括でデータを取り出せるため非常に使い勝手が良いメソッドです。しかし、配列要素を単純に `r.join(“,”)` で結合する方式では、データの中に含まれる特定の文字が原因でファイル全体の構造が狂うリスクを常に抱えています。

例えば、住所データの中に「1-2-3, 建物名」のようにカンマが含まれている場合や、自由記述欄のセル内に文章の改行が入っている場合を考えてみてください。単にカンマで連結するだけの処理では、住所内のカンマが「次の列への区切り」として解釈されてしまい、その行だけ列数が1つ増えて後ろのデータが右にずれてしまいます。また、セル内の改行文字はCSV全体の行区切りとして誤認され、1つのレコードが途中で切れて複数行に分かれてしまいます。これらを正しくCSV規格（RFC 4180など）に準拠した形式で出力するには、各セルのデータにカンマや改行、あるいは二重引用符（ダブルクォーテーション `”`）が含まれている場合に、セル全体をダブルクォーテーションで囲み、内部のダブルクォーテーションを `””` にエスケープする処理を追加しなければなりません。

また、データ型に由来する表記のずれも考慮する必要があります。`getValues()` はセル内の値をJavaScriptの型に変換して取得するため、日付セルは `Date` オブジェクトとして取り出されます。これをそのまま文字列化すると `Mon Oct 23 2023 09:00:00 GMT+0900 (Japan Standard Time)` のような長いフォーマットに変化してしまい、元のシートで「2023/10/23」と見えていた表記とは大きく乖離します。スプレッドシート上で見えている表記通りにCSVへ出力したい場合は、`getValues()` の代わりに `getDisplayValues()` を使用するか、スクリプト内で日付フォーマットを明示的に整える処理を行わなければなりません。`getDisplayValues()` は全要素を画面表示通りの文字列として取得するため、日付や通貨表示を維持したい場合に極めて有効ですが、数値が文字列化されるため計算用データとしては適さなくなる場合もあります。連携先システムがどのような入力を求めているかに応じて、型の扱いを選択する記述が求められます。

エスケープ処理を組み込んだ堅牢なCSV生成ロジック

セル内の特殊文字による列ズレを防ぎ、他ツールへ渡す前に耐えうる正確なテキストデータを生成するには、1セルごとに適切な判定を行う関数を噛ませてから文字列を作成します。前述した基本コードの `map` 処理部分を拡張し、厳密なエスケープロジックを実装する考え方を整理します。

具体的な処理の流れとしては、2次元配列のすべての要素に対して走査を行い、各要素が文字列か数値か、あるいはNullやUndefinedであるかを確認します。要素内に半角カンマ、改行（`\n` または `\r\n`）、あるいはダブルクォーテーションが含まれているかどうかを判定し、該当する文字が1つでも含まれる場合は、要素内のダブルクォーテーションを2つ連続させた `””` に置換した上で、要素全体をダブルクォーテーションで囲みます。これにより、どんなに複雑な文章や住所データがセル内に入っていても、CSVリーダーや他ツールのインポーターが「1つのセル内のデータ」として正しく認識できるようになります。

また、大量の行数を扱うスプレッドシートにおいては、メモリ消費量と処理時間にも配慮が必要です。GASには1回の実行時間の上限（通常のアカウントで6分）が存在します。数万行に及ぶ大きな表データを1セルずつ低効率なループ処理で回していると、スクリプトが途中でタイムアウトを起こし、不完全なCSVファイルが作成されたり、途中で処理が崩壊したりします。そのため、配列のループには高速に動作する組み込みの `map` メソッドを活用し、文字列の置換処理には正規表現を用いて一括処理する構成が推奨されます。セルデータがNullや空文字の場合にも安全に動作するよう、三項演算子やデフォルト値を設定しておくことで、エラーによる処理中断を未然に防ぐことができます。

文字コード変換とShift_JIS（Windows-31J）の壁を越える方法

Google Apps Script内で生成される文字列は、デフォルトですべて UTF-8 のエンコーディングとして扱われます。Webベースのモダンなツールやクラウドサービスへ取り込む場合は UTF-8 のままで問題ありませんが、日本の伝統的な基幹システムや、古いバージョンのExcelで直接CSVファイルを開く運用が残っている現場では、UTF-8 のCSVを開くと激しく文字化けを起こすケースが多発します。

このような文字化け問題を解決するためには、生成したテキストをShift_JIS（実質的にはWindows環境で標準的に使われる Windows-31J / CP932）に変換してドライブへ書き出す必要があります。しかし、`DriveApp.createFile` メソッドに直接JavaScriptの文字列を渡してしまうと、強制的に UTF-8 でファイルが作成されます。この仕様を回避するためには、文字列を一度 `Blob` オブジェクトに変換し、そのBlobに対して明示的に charset を指定する手順を踏まなければなりません。

具体的には、`Utilities.newBlob` を使用してCSV文字列からBlobオブジェクトを生成します。その際、`setOption(‘charset’, ‘Shift_JIS’)` または `setOption(‘charset’, ‘Windows-31J’)` を呼び出してから、`DriveApp.createFile(blob)` を実行します。この変換ステップを挟むことで、出力されるバイナリデータが Shift_JIS にエンコードされ、古いシステムや標準設定のExcelで開いても文字化けしないCSVファイルがドライブ上に生成されます。ただし、Shift_JIS に変換する際には注意点もあります。スプレッドシートのセル内にShift_JISで表現できない特殊な記号や絵文字（例えば「髙」などの環境依存文字や各種アイコン）が含まれている場合、文字化けや?記号への置換、最悪の場合はエンコードエラーが発生します。運用前に対象のシートに入力される文字の制約を確認し、必要に応じて不要な特殊記号を除去するサニタイズ処理をコード側に加えておくことが安全なシステム運用のポイントです。

保存先のフォルダ指定と同名ファイルの重複を防止する運用設計

最初に提示した基本コードでは、作成されたCSVファイルは実行者の「マイドライブ」直下に保存されます。しかし、定時実行のトリガーなどで自動書き出しを運用する場合、マイドライブのルート階層にファイルが散乱し、どのファイルが最新であるかの判別が困難になります。また、同じ名前のファイルが何十個も重複して作成され、ストレージ容量や管理上の事故を引き起こす原因になります。

実務で耐えうるスクリプトにするためには、あらかじめ出力先の専用フォルダを用意し、そのフォルダのIDを指定してファイルを作成する構造に変更します。`DriveApp.getFolderById(“フォルダID”)` を使用して対象のフォルダオブジェクトを取得し、そのフォルダに対して `createFile` を呼び出すように書くのが基本です。

さらに、同名ファイルが存在した場合の挙動についても設計が必要です。Googleドライブは一般的なファイルシステムと異なり、同じフォルダ内に同一のファイル名を持つファイルを複数存在させることが可能です。そのため、何の考慮もせずに毎回 `createFile` を呼び出すと、同名のファイルが何冊も平行して並んでしまいます。これを防ぐアプローチは主に2つあります。1つ目は、ファイル名に実行時の日付スタンプ（例: `export_20231023_0900.csv`）を付与して履歴として残す方法です。2つ目は、保存先のフォルダ内を検索し、既存の同名ファイルが存在すれば `file.setTrashed(true)` でゴミ箱へ移動させるか、あるいは内容を上書き更新する方法です。後者の上書きを行う場合は、既存ファイルのIDを変更せずに中身のBlobだけを更新することで、そのファイルに対して共有リンクを発行している場合でもURLを変えずに最新のCSVデータへ差し替えることが可能になります。こうした保存ロジックの整理によって、スプレッドシートの表を、ドライブにCSVで書き出す一連の自動化処理が、安定した実効性を持つ業務システムへと進化します。

タイトルとURLをコピーしました