前回の第41回では、DriveApp.getFolderById() を使って Google Drive 上の特定のフォルダをGASプログラムから操作対象として読み込む方法を学びましたね。操作したい「箱(フォルダ)」をピンポイントで掴む感覚が掴めたのではないでしょうか。
特定フォルダの準備ができたら、次にやりたくなるのは「そのフォルダの中に、GASで生成したテキストファイルやログファイル、CSVファイルなどを自動で新規作成して保存すること」ですよね!
業務で「日次レポートのテキストを自動保存したい」「フォームの回答結果をCSVとして特定のフォルダに整理して書き出したい」といった場面でも欠かせないテクニックです。
第42回となる今回は、指定したフォルダの中に新しいファイルを自動生成するメソッド Folder.createFile() を徹底解説します!
秋のドライブシーズンに向けた「おすすめドライブコース.txt」を Google Drive 内のフォルダへ自動作成する実践コードを書きながら、引数の渡し方から実務で役立つCSV作成応用、初心者が必ずハマる注意点まで、どこよりも分かりやすく噛み砕いてお届けします。
1. そもそも Folder.createFile() とは?
Folder.createFile() は、取得した特定フォルダ(Folderオブジェクト)の中に、指定したファイル名とテキスト内容で新しいファイルを自動生成する命令(メソッド)です。
「引き出しとノート」の例えでイメージしてみよう!
本連載でおなじみの例えで整理してみましょう。
DriveApp= Google Drive という巨大な書庫全体Folder= 書庫の中にある「特定の棚・引き出し」(例:第41回で取得した「北海道旅行写真」フォルダ)File= 引き出しの中に入れる「書類やノート」
前回学んだ DriveApp.getFolderById() で「特定の引き出し」を開けた状態にしました。
今回の Folder.createFile() は、まさにその「引き出しの中に、新しいノート(ファイル)をサッと作成して仕舞う操作」にあたります。
基本的なコードの構文
Folder.createFile() には、主に以下の2通りの書き方があります。
パターン①:ファイル名とテキスト内容を指定して作成する(最も基本!)
// folder.createFile(ファイル名, ファイルの中身のテキスト);
folder.createFile("おすすめドライブコース.txt", "1. 札幌出発\n2. 定山渓で紅葉鑑賞\n3. 小樽でランチ");
パターン②:MIMEタイプ(ファイル形式)を明示して作成する
// folder.createFile(ファイル名, 内容, MimeType);
folder.createFile("ドライブスポット.csv", "エリア,スポット名\n南区,定山渓温泉\n小樽,運河", MimeType.CSV);
ファイル名と中身の文字列を指定するだけで、指定フォルダの中にテキストファイル(またはCSVなど)が一瞬で生成されます!
2. DriveApp.createFile() と Folder.createFile() の違い
GASを学んでいると、DriveApp 親玉自体にも DriveApp.createFile() という似た命令があることに気づくかもしれません。
この2つは「どこにファイルが作られるか」が全く異なりますので、しっかり整理しておきましょう!
| 項目 | DriveApp.createFile() | Folder.createFile() ★今回学ぶ命令 |
| 作成場所 | マイドライブの直下(最階層) | 指定した特定フォルダの中 |
| 事前準備 | フォルダの指定不要 | getFolderById() などで事前にフォルダを取得する必要あり |
| 主な用途 | とりあえずマイドライブに保存したい時 | 整理された業務フォルダやプロジェクトフォルダ内に保存したい時 |
整理整頓されたDrive環境を保つためには、マイドライブ直下にファイルを散らかすのではなく、前回学んだ DriveApp.getFolderById() と今回の Folder.createFile() を組み合わせて「決まったフォルダの中に保存する」のがスマートな自動化の鉄則です。
3. STEP1:準備!「北海道ドライブ計画」フォルダを作成してFolder IDを取得しよう
まずは、GASからファイルを自動生成して保存するための練習用フォルダを Google Drive 上に用意しましょう。
手順
- Google Drive を開く
ブラウザで Google Drive(マイドライブ)を開きます。 - 新しいフォルダを作成する
左上の「+ 新規」ボタン >「新しいフォルダ」をクリックし、フォルダ名を北海道ドライブ計画にして作成します。 - フォルダIDを取得する
作成した「北海道ドライブ計画」フォルダをダブルクリックして開きます。ブラウザのURLバーを確認すると、以下のような形式になっているはずです。https://drive.google.com/drive/folders/1a2b3c4d5e6f7g8h9i0j_EXAMPLE_ID
このfolders/の後ろにある英数字の羅列(上記例では1a2b3c4d5e6f7g8h9i0j_EXAMPLE_ID)がフォルダIDです。これをコピーしておきましょう!
4. STEP2:【実践】指定フォルダ内に「おすすめドライブコース.txt」を作成してみよう!
準備ができたら、スプレッドシート(またはスタンドアロン)から GAS のエディタ画面(「拡張機能」>「Apps Script」)を開き、コードを書いていきましょう。
今回は、コピーしたフォルダIDを使って指定フォルダを呼び出し、その中に秋の道央を満喫する「おすすめドライブコース.txt」を自動生成してみます!
1. コードを入力する
エディタ画面のコードをすべて消去し、以下のコードを貼り付けます。
※ YOUR_FOLDER_ID_HERE の部分をご自身のフォルダIDに置き換えてくださいね。
function createDriveCourseFile() {
// ① 対象のフォルダIDを指定(ご自身のフォルダIDに書き換えてください)
var folderId = "YOUR_FOLDER_ID_HERE";
// ② 前回(第41回)学んだ命令で「北海道ドライブ計画」フォルダを取得する
var folder = DriveApp.getFolderById(folderId);
// ③ 作成したいファイル名とテキスト内容を準備する
var fileName = "おすすめドライブコース.txt";
var fileContent = "【秋の札幌近郊ドライブおすすめプラン】\n"
+ "1. 札幌オフィス出発(朝8:00)\n"
+ "2. 定山渓温泉で紅葉と足湯を満喫\n"
+ "3. 中山峠で名物「あげいも」をテイクアウト!\n"
+ "4. 帰りにセイコーマートでホットシェフのカツ丼を買って帰宅\n"
+ "\n作成日: " + Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyy/MM/dd HH:mm");
// ④ フォルダ内にテキストファイルを自動生成する
var createdFile = folder.createFile(fileName, fileContent);
// ⑤ 実行ログで作成されたファイルのIDと名前を確認する(第1回の Logger.log を活用!)
Logger.log("ファイルを作成しました!");
Logger.log("■ ファイル名: " + createdFile.getName());
Logger.log("■ ファイルID: " + createdFile.getId());
}
2. コードを1行ずつ徹底解説!
var folder = DriveApp.getFolderById(folderId);
前回第41回で解説した必須命令ですね!指定したIDのフォルダオブジェクトを取得して変数folderに入れています。\n(改行コード)
テキストの中で改行したいときは、半角の\n(環境によっては\nまたは¥n)を挟みます。Utilities.formatDate(...)
第29回で学んだ日付整形の便利機能です!作成時点の現在日時を「2026/09/23 10:00」のような読みやすい形式に変換して本文に盛り込んでいます。var createdFile = folder.createFile(fileName, fileContent);
本日の主役です!取得したfolderに対して.createFile()を呼び出し、ファイル名と本文テキストを渡しています。戻り値として作成されたFileオブジェクトが返ってきます。createdFile.getName(),createdFile.getId()
生成されたファイルから、ファイル名や固有のファイルIDを取得できます。
3. 保存して実行する
- エディタ上部の 「保存アイコン(フロッピーディスク)」 をクリックします。
- 関数が
createDriveCourseFileになっていることを確認し、「実行」 をクリックします。 - (初回実行時のみ)第2回で解説したGoogleアカウントの権限承認画面(アクセス許可)が出たら、画面の指示に従って「許可」を行います。
【実行結果の確認】
実行後、Google Drive の「北海道ドライブ計画」フォルダの中を開いてみましょう!
フォルダ内に おすすめドライブコース.txt というファイルが新しく生成されていれば大成功です!ダブルクリックして開くと、\n で指定した通りの改行付き文章と、実行した日時が綺麗に書き込まれているはずですよ。
エディタ下部の実行ログにも以下のように表示されます。
情報 ファイルを作成しました!
情報 ■ ファイル名: おすすめドライブコース.txt
情報 ■ ファイルID: 1x2y3z...(固有のID)
5. STEP3:実務で使える!CSVファイルの自動生成応用
テキストファイル(.txt)だけでなく、ビジネス現場で非常によく使われるのが CSVファイル(カンマ区切りのデータファイル) の自動生成です。
スプレッドシートのデータをCSVにしてDriveの共有フォルダに書き出したい場合や、他システムへ読み込ませるためのデータを出力したい場合にも、Folder.createFile() が大活躍します!
カンマ区切りテキストからCSVファイルを作成する例
function createSeicomaDriveCsv() {
var folderId = "YOUR_FOLDER_ID_HERE"; // ご自身のフォルダID
var folder = DriveApp.getFolderById(folderId);
// CSV用のデータ文字列を作成(1行目がヘッダー、2行目以降がデータ)
var csvData = "エリア,店舗名,おすすめ立ち寄りグルメ\n"
+ "南区,セイコーマート 定山渓店,ホットシェフのフライドチキン\n"
+ "喜茂別町,セイコーマート 喜茂別店,100円惣菜のパスタ\n"
+ "小樽市,セイコーマート 小樽銭函店,くるみ大福";
// ファイル名と内容、そして第3引数に MimeType.CSV を指定する
var csvFile = folder.createFile("ドライブ立ち寄りセコマ一覧.csv", csvData, MimeType.CSV);
Logger.log("CSVファイルを生成しました: " + csvFile.getName());
}
第3引数に MimeType.CSV を指定することで、Google Drive 上で明示的にCSVファイルとして作成することができます。これを実行すると、Excelやスプレッドシートで直接開けるCSVファイルがフォルダ内に一瞬で生成されますよ!
6. 初心者が絶対につまずく!4大トラップと解決策
Folder.createFile() を使う際、プログラミング初心者やGAS学習者がよく遭遇する落とし穴と解決策を4つまとめました。あらかじめ確認しておきましょう!
トラップ1:実行するたびに「同名ファイル」が大量に増えてしまう!
WindowsやMacのローカルパソコンでは、同じフォルダの中に「同じファイル名」のファイルを2つ作成しようとすると「上書きしますか?」と聞かれたり、自動で おすすめドライブコース (1).txt のようにリネームされますよね。
しかし、Google Drive は「同じフォルダ内にまったく同じ名前のファイルを複数作成できる」という仕様を持っています!
そのため、GASで createFile() を何度も実行すると、同じ「おすすめドライブコース.txt」というファイルがフォルダ内に何個も重なって生成されてしまいます。
【解決策】
既存の同名ファイルを上書きしたい(または事前に消したい)場合は、今後詳しく学ぶ Folder.getFilesByName() を使って既存ファイルを検索してゴミ箱へ移動(setTrashed(true))させてから新規作成するか、ファイル名に「作成日時(タイムスタンプ)」を付与してユニークにするのが実務的なテクニックです。
// 例:ファイル名に「20250923_104000」のような日時をつけて同名化を防ぐ
var timeStamp = Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyyMMdd_HHmmss");
var fileName = "おすすめドライブコース_" + timeStamp + ".txt";
トラップ2:DriveApp.createFile() と間違えてマイドライブ直下に作ってしまう
var file = DriveApp.createFile("test.txt", "内容"); と書いてしまうと、せっかく準備した「北海道ドライブ計画」フォルダではなく、マイドライブの最上層(一番散らかりやすい場所)にファイルが生成されてしまいます。
必ず第41回で学んだ DriveApp.getFolderById() で取得した folder 変数に対して .createFile() を呼び出す ようにコードをチェックしましょう!
// ✕ マイドライブ直下に作成されてしまう
DriveApp.createFile(fileName, content);
// ◯ 目的の特定フォルダの中に作成される
folder.createFile(fileName, content);
トラップ3:引数の順番を間違えてエラーになる
Folder.createFile() の引数の順番は厳密に決まっています。
- 第1引数:ファイル名(
String) - 第2引数:ファイルの中身(
StringまたはBlob) - 第3引数:(任意)MIMEタイプ(
MimeType)
間違えて folder.createFile(content, fileName); のように「中身」と「ファイル名」の順番を逆にしてしまうと、文章がそのまま長〜いファイル名になってしまったり、エラーの原因になります。「名前が先、中身が後!」と覚えておきましょう。
トラップ4:改行コードで全角の「¥」や「/」を使ってしまう
文章の中で改行を入れたい時に、環境やキーボードの入力モードによって全角の ¥n や /n と打ってしまうと、改行されずにそのまま文字として出力されてしまいます。
必ず半角英数の \n(Macの場合は Option + ¥ キーなどで入力できるバックスラッシュ \n)で記述できているか確認しましょう。
7. 今回のまとめと次回予告
今回は、Google Driveの指定フォルダ内にファイルを自動生成する Folder.createFile() を詳しく解説しました。
今日の重要ポイントおさらい
Folder.createFile(name, content)で特定フォルダ内にファイルを直接自動生成できる- 整理整頓のため、
DriveApp.getFolderById()でフォルダを掴んでから使うのが鉄則 \nを使うとテキスト内で改行が表現できる- 第3引数に
MimeType.CSVを渡せばCSVファイルの自動生成も可能 - Google Driveは同名ファイルを重複作成できるため、ファイル名に日時(タイムスタンプ)を付ける工夫が有効
これで、「フォルダを取得して(第41回)、その中に新しいファイルを生成する(第42回)」という Drive 操作の基本的な流れがマスターできましたね!
さて、特定フォルダの中にファイルを作成できるようになったら、次は「そのフォルダの中に今どんなファイルが入っているか、一覧を取得して調べたい!」という場面が出てきますよね。
次回(第43回)は、指定フォルダ内の全ファイルをGASでループ処理して取得する Folder.getFiles() を解説します!
