【GAS入門#45】ファイル名をプログラムで一括変更!File.setName()の使い方と実践テクニック

Googleドライブで業務ツールやレポートを作成していると、「生成したファイル名に今日の日付を入れて保存したい」「テンプレートを複製したあとに『〇〇様向け』と名前を変えたい」「大量にあるファイルの命名ルールを一括で統一したい」と思う瞬間がたくさんありますよね。

手動で1つずつ右クリックして「名前を変更」を選ぶこともできますが、件数が増えると時間がかかりますし、日付の打ち間違いや半角・全角の表記ブレなどのミスも起きやすくなります。私も、月末の月次報告書のファイル名が人によってバラバラで、後から検索するときに苦労した……なんて苦い経験がありました。

そこで今回は、Googleドライブ上のファイル名をGAS(Google Apps Script)から自動で変更できる必須メソッド File.setName() を徹底解説します!

第41回で学んだ DriveApp.getFolderById() や、第44回で学んだ File.makeCopy()(ファイルのコピー作成)とも相性抜群の命令です。実際のコード例や実務で役立つ応用パターン、初心者がハマりやすい注意点まで、どこよりも分かりやすく紐解いていきますね!

1. そもそも File.setName() とは?

File.setName() は、指定したファイル(Fileオブジェクト)の ファイル名をプログラムから新しい文字列へ変更(リネーム)する命令 です。

コードの構造を分解してみよう

file.setName("新しいファイル名");
  • file:操作対象となるファイル(Fileオブジェクト)が入った変数です。第41回などで学んだ DriveApp.getFileById() や Folder.getFiles() などで取得したオブジェクトを指します。
  • .setName()(セット・ネーム):Fileオブジェクトに対して「ファイル名をカッコの中の文字に変更してね!」と指示を出す命令(メソッド)です。

「書類バインダーの背表紙」でイメージしよう!

本連載でおなじみの例えで整理してみましょう。

  • 【フォルダ】= 書類棚(Folder)(第41〜42回)
  • 【ファイル】= 棚に入っている1冊の書類バインダー(File)
  • 【File.setName()】= バインダーの背表紙(表札ラベル)を新しいシールで貼り替える操作

バインダーの中身(ドキュメントの本文やスプレッドシートのデータ)には一切手を加えず、外側のタイトル(ファイル名)だけをサッと綺麗に書き換える のが setName() の役割です。

2. STEP1:準備!「札幌オフィスの月次報告書」を用意しよう

まずは、今回GASから名前を変更するための練習用ファイルと、その「ファイルID」を準備していきましょう。

手順

  1. Googleドライブ を開きます。
  2. 左上の「新規」ボタンから、練習用の Googleドキュメント(またはスプレッドシート)を1つ作成します。
  3. ファイル名を初期状態の 「無題のドキュメント」(または 月次報告_未整理)にしておきます。
  4. ブラウザのアドレスバー(URL)を確認し、ファイルID をコピーします。
https://docs.google.com/document/d/【ここの英数字の羅列がファイルID】/edit

※ファイルIDの確認方法は第41回や第51回でも解説していますが、d/ と /edit に挟まれた長い英数字の文字列のことです。手元にメモしておきましょう!

3. STEP2:【実践】ファイル名を「20260915_札幌オフィス月次報告」に変更してみよう!

準備ができたら、GASのエディタを開いて実際にコードを書いていきましょう。

今回は、指定したファイルの名称を 「20260915_札幌オフィス月次報告」 という整ったタイトルへ自動リネームするプログラムを作成します。

1. コードを入力する

新規スプレッドシートやドキュメントのメニューから 「拡張機能」 > 「Apps Script」 を開き、エディタ画面のコードをすべて消去して、以下のコードを貼り付けます。

function renameMonthlyReport() {
  // ① 変更したいファイルのIDを指定する
  var fileId = "YOUR_FILE_ID_HERE"; // ※ご自身のファイルIDに書き換えてください
  
  // ② DriveAppを使って対象のファイルオブジェクト(バインダー)を取得する
  var myFile = DriveApp.getFileById(fileId);
  
  // ③ ファイル名を変更する前の名前を取得してログに表示(確認用)
  var oldName = myFile.getName();
  Logger.log("変更前のファイル名: " + oldName);
  
  // ④ File.setName() を使って新しいファイル名に変更する
  myFile.setName("20260915_札幌オフィス月次報告");
  
  // ⑤ 変更後のファイル名を取得してログに表示する
  var newName = myFile.getName();
  Logger.log("変更後のファイル名: " + newName);
}

2. コードを1行ずつ丁寧に解説!

  • var myFile = DriveApp.getFileById(fileId);
    指定したIDをもとに、Googleドライブ上のファイルオブジェクトを取得して変数 myFile に格納しています(第41回参照)。
  • var oldName = myFile.getName();
    getName() は、現在のファイル名を取り出す命令です。変更前の状態を確認するためにログ出力用として取得しています。
  • myFile.setName("20260915_札幌オフィス月次報告");
    本日の主役です!取得した myFile に対して .setName() を呼び出し、変更したい新しい文字列を渡しています。

3. 保存して実行する

  1. エディタ上部の 「保存アイコン(フロッピーディスク)」 をクリックします。
  2. 実行する関数が renameMonthlyReport になっていることを確認し、「実行」 ボタンをクリックします。
  3. 初回実行時はGoogleドライブへのアクセス権限を求められるため、承認画面(第2回参照)が出たら「詳細」>「移動」>「許可」の順で許可してください。

実行結果の確認

エディタ下部の「実行ログ」に以下のように表示されれば大成功です!

情報    変更前のファイル名: 無題のドキュメント
情報    変更後のファイル名: 20260915_札幌オフィス月次報告

Googleドライブの画面に戻って確認してみると、ファイル名が即座に 「20260915_札幌オフィス月次報告」 へと切り替わっているはずです!

4. STEP3:実務で差がつく!File.setName() の応用パターン3選

単に固定の文字へ変更するだけでなく、実務で業務自動化を組む際に欠かせない 3つの発展テクニック をご紹介します。

応用①:現在の日時(日付)を動的にファイル名へ組み込む

「実行した日の日付」を自動でファイル名につけたい場合、日付をコード内に直接書く(ハードコードする)のではなく、JavaScriptの Date や Utilities.formatDate()(第29回参照)を使って動的に生成するのがスマートです。

function renameWithTodayDate() {
  var fileId = "YOUR_FILE_ID_HERE";
  var myFile = DriveApp.getFileById(fileId);
  
  // 本日の日付を「YYYYMMDD」形式の文字列にする(例: 20260915)
  var today = new Date();
  var dateString = Utilities.formatDate(today, "Asia/Tokyo", "yyyyMMdd");
  
  // 日付 + 固定テキスト で新しいファイル名を作成
  var newTitle = dateString + "_札幌オフィス月次報告";
  
  // リネーム実行!
  myFile.setName(newTitle);
  Logger.log("ファイル名を「" + newTitle + "」に更新しました!");
}

このコードを毎月1日などの時間主導型トリガー(第23回参照)で自動実行するようにセットしておけば、人間が日付を意識しなくても、常に実行日の日付が付与された正確なファイル名 が自動で完成します!

応用②:テンプレートから複製(makeCopy)した直後にリネームする

第44回で学んだ File.makeCopy()(ファイルの複製)と組み合わせるパターンです。

makeCopy() をそのまま使うと、複製されたファイル名は自動的に [元のファイル名] のコピー になってしまいます。複製直後に setName() を実行することで、最初から希望通りの名前で保存できます。

function createReportFromTemplate() {
  // テンプレートファイルのID
  var templateId = "YOUR_TEMPLATE_FILE_ID";
  var templateFile = DriveApp.getFileById(templateId);
  
  // 1. テンプレートをコピー作成(第44回)
  var newFile = templateFile.makeCopy();
  
  // 2. コピーした新規ファイルの名前を即座に変更!
  var clientName = "札幌ITソリューションズ";
  newFile.setName("【提出用】" + clientName + "_月次レポート");
  
  Logger.log("作成完了!ファイルURL: " + newFile.getUrl());
}

新千歳空港での移動中や出張先からでも、フォームにクライアント名を入力するだけで、命名ルールが完璧に整った提案書やレポートが一瞬で複製作成できるようになりますよ。

応用③:フォルダ内の複数ファイルをルールに従って一括リネーム

第43回で学んだ Folder.getFiles()(フォルダ内のファイル一覧取得)と while ループを組み合わせれば、フォルダの中にある大量のファイルを一括でリネームできます。

例えば、「フォルダ内のすべてのファイル名の先頭に 【確認済み】_ を追加する」という処理を書いてみましょう。

function batchRenameInFolder() {
  // 対象フォルダのID(第41回)
  var folderId = "YOUR_FOLDER_ID_HERE";
  var folder = DriveApp.getFolderById(folderId);
  
  // フォルダ内のファイル一覧(イテレータ)を取得(第43回)
  var files = folder.getFiles();
  
  // 順番に全ファイルを処理する
  while (files.hasNext()) {
    var file = files.next();
    var currentName = file.getName();
    
    // すでに【確認済み】がついていない場合のみリネーム
    if (currentName.indexOf("【確認済み】_") === -1) {
      file.setName("【確認済み】_" + currentName);
      Logger.log("リネーム完了: " + file.getName());
    }
  }
}

100冊あるファイルも、わずか数秒で綺麗にルール統一された名前へと一括変更されます。手作業で1つずつ書き換えていたあの時間が嘘のように浮きますね!

5. 初心者が絶対につまずく!5大トラップと完全解決策

File.setName() を使う際、プログラミング初心者やGAS学習者が非常によく遭遇するエラーやトラブルを5つ厳選しました。あらかじめ知っておくことで、無用なトラブルを回避しましょう!

トラップ1:DriveApp.setName() と書いて TypeError になる

ついついやってしまいがちなのが、以下のような書き方です。

// ✕ エラーになる書き方(DriveAppにsetNameはありません)
DriveApp.setName("20260915_札幌オフィス月次報告");
// エラーメッセージ:TypeError: DriveApp.setName is not a function

setName() は DriveApp(親玉)が持っている命令ではなく、個別の File(ファイルオブジェクト)が持っている命令 です。

必ず DriveApp.getFileById() や Folder.getFiles() などで 特定のファイルを取得してから、その変数に対して .setName() を呼び出す ようにしましょう。

トラップ2:PDFやExcelファイルの「拡張子(.pdf, .xlsx)」を消してしまう

GoogleドキュメントやスプレッドシートなどのGoogle Workspace専用ファイルは、ファイル名に .docx や .xlsx といった拡張子が表示されません。

しかし、Googleドライブ上に保存された PDFファイル、画像(.png, .jpg)、Excelファイル(.xlsx)、CSVファイル などを setName() でリネームする際は注意が必要です!

// ✕ トラップ:拡張子を消してしまうとプレビューや開く動作で不具合が起きる場合がある
var pdfFile = DriveApp.getFileById("PDF_FILE_ID");
pdfFile.setName("20260915_請求書"); // .pdf が消えてしまう!

// ◯ 解決策:元の拡張子を維持してリネームする
var pdfFile = DriveApp.getFileById("PDF_FILE_ID");
pdfFile.setName("20260915_請求書.pdf");

外部ファイルをリネームする際は、末尾に .pdf や .xlsx などの拡張子を忘れずにつけるか、元のファイル名から拡張子をプログラムで抽出して結合する工夫をしましょう。

トラップ3:文字列を ” ” で囲み忘れて構文エラー(SyntaxError)になる

ファイル名に数字から始まる文字列を設定しようとした際によく起きるミスです。

// ✕ NG:ダブルクォーテーションがないため数値や構文エラーとみなされる
myFile.setName(20260915_札幌オフィス月次報告); 

// ◯ OK:文字列として " "(ダブルクォーテーション)で囲む
myFile.setName("20260915_札幌オフィス月次報告");

ファイル名はテキスト(文字列)データですので、必ず半角のダブルクォーテーション " "(またはシングルクォーテーション ' ')で囲む必要があります。

トラップ4:編集権限がないファイルの名前を変更しようとしてエラーになる

自分に「閲覧者」権限しか与えられていない(他の人が所有している)共有ファイルに対して setName() を実行すると、権限エラーが発生します。

Exception: この操作を実行する権限がありません。

ファイル名を変更できるのは、ファイルの所有者(オーナー)または「編集者」権限を持っているユーザーのみ です。エラーが出た場合は、対象ファイルの共有設定やアクセス権限を確認してみましょう。

トラップ5:同名のファイルが複数作成できてしまいフォルダ内が混乱する

パソコン(WindowsやMac)のローカルフォルダでは、同じフォルダ内にまったく同じ名前のファイルを置こうとすると「同名のファイルが存在します」と警告が出ますよね。

しかし、Googleドライブは内部的に「ファイルID」でファイルを識別しているため、同じフォルダ内に全く同じ名前のファイルを何個でも置くことができてしまいます!

エラーにはなりませんが、Googleドライブ上に「20260915_札幌オフィス月次報告」という同名ファイルが10個並んでしまうと、どれが最新データなのか分からず大混乱に陥ります。

必要に応じて、事前に同じ名前のファイルが存在しないかチェックするか、タイムスタンプ(日時・分・秒まで含む文字列)を付与して一意のファイル名にする工夫を取り入れましょう。

6. 今回のまとめと次回予告

今回は、Googleドライブ上のファイル名を自由自在に変更する File.setName() について徹底解説しました!

今日の重要ポイントおさらい

  1. File.setName("新しい名前") はファイルの表示名(タイトル)を変更する命令
  2. DriveApp.getFileById() などで特定の File オブジェクトを取得してから呼び出す
  3. Utilities.formatDate() と組み合わせることで、日付入りの動的なファイル名を自動生成できる
  4. File.makeCopy()(第44回)や Folder.getFiles()(第43回)と組み合わせると実務の効率が飛躍的にアップする
  5. PDFやExcelファイルのリネーム時は .pdf などの拡張子の扱いに注意する

ファイル名の命名ルールが自動で整うようになると、検索性が上がり、チーム内での共有ミスや確認の手間も一気に減らせますよ。

さて、ファイル名を綺麗に整えられるようになったら、次にやりたくなるのは 「処理が終わったファイルを専用のフォルダへ整理整頓して移動すること」 ですよね!

次回(第46回)は、ファイルを指定したフォルダへ自動でお引っ越しさせる File.moveTo() を解説します!

「処理済みの領収書ファイルを『2026年_冬』フォルダへ移動する」といった、デスクトップやドライブを散らかさない究極の整理術を学んでいきましょう。ぜひお楽しみに!