これまで本連載では、Googleスプレッドシートのセル操作やGmailの自動送信など、業務で使えるさまざまな自動化テクニックを学んできました。
しかし、自動化が進んでくると必ずぶつかるのが「ファイルの置き場所問題」です。
- 「GASで自動作成した請求書PDFを、指定のフォルダに自動で格納したい」
- 「フォームから送信された『北海道旅行写真』を、専用フォルダに一括で保存したい」
- 「特定フォルダの中にあるcsvファイルを自動で読み込んでスプレッドシートに転記したい」
こうしたGoogleドライブ(Google Drive)上のファイルやフォルダの管理を行うのが、今回からスタートするフェーズ5「Google Drive・ファイル管理編」です!
その記念すべき第41回でマスターするのは、Googleドライブ内の特定フォルダを一発でピンポイント指定する超基本メソッド DriveApp.getFolderById() です。
「フォルダの指定方法がよくわからない」「フォルダIDってどこにあるの?」というプログラミング初心者の方に向けて、フォルダIDの簡単な見つけ方から、実際のコードの書き方、初心者が100%ハマる落とし穴まで、どこよりも丁寧に解説していきますね!
1. そもそも DriveApp.getFolderById() とは?
呪文のように見える英単語ですが、構造を分解してみると実はとてもシンプルな役割を持っています。
DriveApp.getFolderById(id)
コードの構造を分解してみよう
プログラミングの世界では、ドット(.)で繋いで「誰が(対象)」「何をする(命令)」を指定します。
DriveApp(ドライブ・アップ)Googleドライブ全体の機能をまとめて管理している「親玉(サービス)」です。第2回で学んだSpreadsheetAppや第31回で学んだGmailAppと同じ仲間の存在ですね。「今からGoogleドライブの操作をするよ!」と宣言する役割を果たします。.getFolderById()(ゲット・フォルダ・バイ・アイディ)DriveAppという親玉に対する命令(メソッド)です。カッコの中に指定した「Folder ID(フォルダ識別子)」を頼りに、「指定された固有IDを持つフォルダを1つ探して持ってきて!」 と指示を出しています。
「コインロッカーの鍵番号」でイメージしよう!
Googleドライブの中には、あなたが作成した無数のフォルダが存在していますよね。
人間であれば、画面を目で見て「『北海道旅行写真』という名前のフォルダ」をダブルクリックして開くことができます。しかし、プログラム(GAS)は画面の見た目で探すことができません。
しかも、Googleドライブは仕様上、「まったく同じ名前のフォルダ」を同じ場所に何個でも作成できてしまうという特徴があります(例えば「無題のフォルダ」が3つ並んでいてもエラーになりません)。
そのため、GASに「『北海道旅行写真』フォルダを開いて!」と名前で指示を出すと、同名のフォルダがあった場合にどれを操作すればいいのか迷ってしまうのです。
そこで登場するのが Folder ID(フォルダID) です。
Googleドライブ上のすべてのフォルダには、作成された瞬間に地球上で唯一の「固有の記号(ID)」が付与されます。例えるなら、巨大なコインロッカー街にある「鍵番号」や「マイナンバー」のようなものです。
DriveApp.getFolderById("ロッカーの鍵番号") と指定することで、GASは迷うことなく目的のフォルダをピンポイントで掴むことができる仕組みになっています!
2. 超重要!「Folder ID(フォルダID)」の探し方・見分け方
「フォルダIDが必要なのは分かったけれど、そのIDはどこで確認するの?」と思いますよね。
実は、ブラウザでGoogleドライブを開いたときの「URL(アドレスバー)」を見るだけで、一瞬で確認できます!
フォルダIDの抜き出し手順
- ブラウザ(Google Chromeなど)で Googleドライブ を開きます。
- 操作対象にしたいフォルダ(例:「北海道旅行写真」)をダブルクリックして開きます。
- 画面最上部にあるブラウザのアドレスバー(URL)を確認します。
URLは、以下のような形式になっているはずです。
https://drive.google.com/drive/folders/1a2b3c4d5e6f7g8h9i0j_kLmA-zYXwVT
このURLのうち、/folders/ の後ろに続く英数字と記号の羅列が、そのフォルダ固有の Folder ID です!
| URLの構造 | 説明 |
https://drive.google.com/drive/folders/ | 共通のベースURL(ここはIDではありません) |
1a2b3c4d5e6f7g8h9i0j_kLmA-zYXwVT | ★ これが Folder ID です! |
⚠️ 絶対にやってはいけない注意点!
コードを書く際、DriveApp.getFolderById() のカッコの中にURL全体を入れてしまわないように注意してください!
- ✕ 間違った書き方(URL全体を入れている)
DriveApp.getFolderById("(https://drive.google.com/drive/folders/1a2b3c4d5e6f7g8h)...")Error 404 (見つかりませんでした)!!1 - ◯ 正しい書き方(IDの文字列だけを入れている)
DriveApp.getFolderById("1a2b3c4d5e6f7g8h9i0j_kLmA-zYXwVT")
URL全体を入れてしまうと、GASが「そんなIDのフォルダは存在しないよ!」とエラーを出してしまいます。末尾のID部分だけを慎重にコピーして使いましょう。
3. STEP1:準備!Googleドライブに「北海道旅行写真」フォルダを作成しよう
それでは、実際にGASからフォルダを取得する練習をするために、テスト用のフォルダを用意していきましょう!
今回は、夏の富良野・美瑛ドライブや定山渓温泉での思い出写真、小樽運河の風景画像などを保存するシーンを想定して、「北海道旅行写真」 というフォルダを作成します。
手順
- Googleドライブ を開きます。
- 画面左上の 「+ 新規」 > 「新しいフォルダ」 をクリックします。
- フォルダ名に 「北海道旅行写真」 と入力し、「作成」ボタンを押します。
- 作成された「北海道旅行写真」フォルダをダブルクリックして開きます。
- アドレスバーのURLから、
/folders/の後ろにある Folder ID をコピーしてメモ帳などに控えおきましょう。
4. STEP2:【実践】GASからフォルダを取得して名前を表示してみよう!
準備ができたら、さっそくGASのエディタを開いてコードを書いていきましょう。
今回は、指定したFolder IDを使ってフォルダを取得し、そのフォルダ名(「北海道旅行写真」)を第1回で学んだ Logger.log() を使って実行ログに出力してみます。
1. スタンドアロンスクリプト(またはコンテナバインド)を開く
Googleドライブの「+ 新規」 > 「その他」 > 「Google Apps Script」 をクリックして、新しいGASエディタを開きます(既存のスプレッドシートの「拡張機能」 > 「Apps Script」 から開いてもOKです)。
2. コードを入力する
エディタに元々書かれている function myFunction() { ... } を消去し、以下のコードをコピー&ペーストしてください。
function getMyHokkaidoFolder() {
// 1. 先ほどメモした「北海道旅行写真」フォルダのIDを入力(※ご自身のIDに書き換えてください)
var folderId = "1a2b3c4d5e6f7g8h9i0j_kLmA-zYXwVT";
// 2. DriveAppを使って指定したIDのフォルダオブジェクト(部屋)を取得する
var targetFolder = DriveApp.getFolderById(folderId);
// 3. 取得したフォルダから「フォルダ名」を取り出す
var folderName = targetFolder.getName();
// 4. 実行ログに表示する
Logger.log("取得したフォルダの名前は:「" + folderName + "」です!");
}
※ var folderId = "..." の中身は、必ずご自身がSTEP1で作成したフォルダのIDに置き換えてくださいね!
3. 初回実行時の「Google Driveへのアクセス承認」をクリアしよう!
コードが入力できたら、エディタ上部の 「保存(フロッピーアイコン)」 を押し、「実行」 ボタンをクリックします。
すると、Google Driveの操作に関するアクセスの初回承認ポップアップが表示されます(※第2回でスプレッドシートの承認を行ったのと同様のセキュリティ確認です)。
承認の手順(3ステップ)
- 「権限を確認」 ボタンをクリックします。
- 自分のGoogleアカウントを選択します。
- 「このアプリは Google で検証されていません」と表示されたら、左下の 「詳細」 をクリックし、「無題のプロジェクト(安全ではないページ)に移動」 をクリックして、最後の画面で 「許可」 を押します。
4. 実行結果の確認
承認が完了すると処理が実行されます。エディタ下部の「実行ログ」エリアを確認してみましょう!
情報 取得したフォルダの名前は:「北海道旅行写真」です!
上記のように表示されれば大成功です!
GASが、指定したFolder IDを頼りにGoogleドライブ内から「北海道旅行写真」フォルダを正しく見つけて持ってきてくれました。
5. 初心者が100%ハマる「4大トラップ」と完全解決策
DriveApp.getFolderById() を使う際、プログラミング初心者が特によく遭遇するエラーやトラブルを4つ厳選しました。エラーが出ても焦らず、以下をチェックしてみてくださいね!
トラップ1:Exception: Invalid argument: id と怒られる
実行時に赤文字で Exception: Invalid argument: id(引数が無効です)と表示された場合、指定したIDの書き方に問題があります。
- 主な原因
- URL全体(
https://drive.google.com/...)をそのまま渡してしまっている。 - IDの前後に余計な空白(スペース)が入っている。
""(ダブルクォーテーション)で囲んでいない。
- URL全体(
- 【解決策】IDは引用符で囲み、URLの
/folders/より後ろの英数字のみを正しく指定しているか見直しましょう。
トラップ2:Exception: No item with the given ID could be found と表示される
「指定されたIDのアイテムが見つかりませんでした」というエラーです。
- 主な原因
- フォルダIDの英字(大文字・小文字)を打ち間違えている。
- 対象のフォルダがゴミ箱に捨てられている、または完全に削除されている。
- ログインしているGoogleアカウントとは別のアカウント(アクセス権限のないアカウント)のドライブ内にあるフォルダIDを指定している。
- 【解決策】フォルダがゴミ箱に入っていないか確認し、アクセスの権限があるアカウントで実行しているかチェックしてください。
トラップ3:DriveApp.getfolderbyid is not a function(タイポ・大文字小文字ミス)
GAS(JavaScript)は、大文字と小文字を厳密に区別します。
- ✕
DriveApp.getfolderbyid()(全部小文字) - ✕
DriveApp.getFolderByID()(IDが両方大文字) - ◯
DriveApp.getFolderById()(F, B, I が大文字) - 【解決策】手入力すると打ち間違いが発生しやすいため、
DriveApp.get...まで打った際に出てくる予測変換(補完機能)を Enter キーや Tab キーで確定させて入力するのが最も確実です!
トラップ4:取得したフォルダ変数から直接ファイルを読み込もうとしてエラーになる
ついついやってしまいがちなのが、以下のような書き方です。
// ✕ エラーになる書き方
var folder = DriveApp.getFolderById(folderId);
var text = folder.getValue(); // Folderオブジェクトに getValue() は存在しません!
第5回で学んだ getValue() や setValue() はスプレッドシートの「セル(Range)」に対する命令です。
Googleドライブの「フォルダ(Folder)」や「ファイル(File)」には、それぞれ専用の命令(getName(), createFile(), getFiles() など)が用意されています。
「今扱っているのはスプレッドシートのセルなのか、ドライブのフォルダなのか」を常に意識することが、エラーを起こさない最大のコツです!
6. ちょっと応用!取得したフォルダの「他の情報」も引き出してみよう
DriveApp.getFolderById() で目的のフォルダ(Folderオブジェクト)を掴むことができたら、フォルダ名以外にもさまざまな情報をプログラムから引き出すことができます。
よく使う便利なメソッドをまとめた応用コードを見てみましょう!
function getFolderDetails() {
var folderId = "1a2b3c4d5e6f7g8h9i0j_kLmA-zYXwVT"; // ご自身のID
var folder = DriveApp.getFolderById(folderId);
// 1. フォルダ名を取得
var name = folder.getName();
// 2. フォルダのWeb URLを取得
var url = folder.getUrl();
// 3. 最終更新日時を取得
var lastUpdated = folder.getLastUpdated();
// 4. フォルダの説明(詳細)を取得
var description = folder.getDescription();
// ログに出力!
Logger.log("■ フォルダ名: " + name);
Logger.log("■ 直リンクURL: " + url);
Logger.log("■ 最終更新日: " + lastUpdated);
Logger.log("■ フォルダの説明: " + description);
}
実行ログの例
情報 ■ フォルダ名: 北海道旅行写真
情報 ■ URL: https://drive.google.com/drive/folders/1a2b3c4d...
情報 ■ 最終更新日: Wed Jul 23 2025 10:00:00 GMT+0900 (Japan Standard Time)
情報 ■ フォルダの説明: null
このように、一度 getFolderById() でターゲットのフォルダを特定しておけば、URLを取得してチームメンバーにSlackやメールで自動共有したり、更新日時を判定して自動整理に活かしたりと、自動化の幅が一気に広がります!
7. 今回のまとめと次回予告
今回は、Googleドライブ操作のすべての起点となる DriveApp.getFolderById() について解説しました。
今日の重要ポイントおさらい
DriveApp.getFolderById()は、固有のIDを使ってGoogleドライブ内の特定フォルダをピンポイント取得する命令- Folder ID は、ブラウザでフォルダを開いた際のURL(
/folders/の後ろの英数字)から抜き出す - URL全体ではなく「IDの文字列だけ」を指定する点に注意する
- 初回実行時にはGoogle Driveへのアクセス許可(承認プロセス)が必要
目的の「部屋(フォルダ)」をGASで掴めるようになったので、次回はいよいよそのフォルダの中に新しいファイルを自動生成してみましょう!
