【GAS入門#49】Googleドライブのファイルを直接ダウンロード!File.getDownloadUrl()で「観光マップPDF」の直リンクを取得しよう

「Googleドライブに保存してあるPDFや画像ファイルを、相手にサッとダウンロードしてもらいたい!」と思うこと、ありませんか?

通常の共有リンクをメールやSlackで送ると、一度Googleドライブの「プレビュー画面」が開いてしまい、右上のダウンロードボタンをクリックしてもらうという一手間が発生してしまいますよね。スマホから開く人や、PC操作に不慣れな人からは「どこからダウンロードするの?」と聞かれてしまうことも……。

そんな時に大活躍するのが、今回ご紹介する File.getDownloadUrl() です!

この命令を使うと、プレビュー画面を挟まずにファイルが直接ダウンロードされる「直リンクURL」をプログラムで一瞬にして取得できます。

今回は「札幌観光マップPDF」を題材に、直リンクURLを取得する方法から、実務で使えるスプレッドシート・Gmail連携、そして初心者が必ずハマる注意点まで、どこよりも分かりやすく徹底解説していきます!

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

File.getDownloadUrl() は、Googleドライブ上にある特定ファイル(PDF、画像、ZIPファイルなど)の直接ダウンロード用URL(ダイレクトダウンロードURL)を取得する命令(メソッド)です。

getUrl() と getDownloadUrl() の違いを理解しよう!

Google Apps Script(GAS)でファイルURLを取得する命令には、よく似た2つのメソッドが存在します。この違いを理解しておくことが、自動化の第一歩です!

項目File.getUrl()File.getDownloadUrl() ★今回の主役
取得できるURLプレビュー画面(閲覧画面)のURL直接ダウンロードが始まるURL
リンクを開いたときの動きブラウザでドライブのプレビュー画面が開くファイルのダウンロードが直接開始される
主な用途ドライブ上で内容を確認・編集してほしいとき資料PDFやZipファイルをすぐ保存させたいとき
対象ファイルすべてのファイル(DocsやSheetsも含む)主に外部ファイル(PDF、画像、Zip、音声等)

例えば、新千歳空港から札幌市内に向かう観光客や取引先に向けて「観光マップPDF」を案内する場合、ドライブの操作画面を見せるよりも、リンクを押したらすぐにスマホへ保存される方が親切ですよね。まさにそんなシチュエーションで威力を発揮するのが getDownloadUrl() なのです!

「家・部屋・家具」の例えで位置づけを整理

本連載でおなじみの例えでおさらいしてみましょう。

  • 【 Googleドライブ全体 】 = 大きな倉庫
  • 【 フォルダ(Folder) 】 = 倉庫の中の各部屋(第41回で解説)
  • 【 ファイル(File) 】 = 部屋の中に保管された「荷物・段ボール」★
  • File.getDownloadUrl() = 荷物を外へ直接運び出す「専用の勝手口シューター」の案内URL

これまでの回でファイルを移動したり(第46回)、名前を変えたり(第45回)する操作を学んできましたが、今回はファイルという荷物を「外部のユーザーへダイレクトに届けるための出口」を作るイメージです!

2. STEP1:準備!Googleドライブに「札幌観光マップPDF」を用意しよう

まずは、GASで直リンクURLを取得するための練習用ファイルを用意しましょう。

手順

  1. Googleドライブ を開きます。
  2. パソコン内にある適当なPDFファイル(名前を 「札幌観光マップ.pdf」 に変更しておくと雰囲気がでます)をGoogleドライブにドラッグ&ドロップでアップロードします。
  3. アップロードしたファイルを右クリックし、「リンクをコピー」 または 「ファイル情報」>「詳細」 を開きます。
  4. URLに含まれる ファイルID を確認します。

💡 ファイルIDの見つけ方

ファイルの閲覧URLが https://drive.google.com/file/d/1a2b3c4d5e6f7g8h9i/view?usp=sharing の場合、/d/ と /view の間にある 1a2b3c4d5e6f7g8h9i というランダムな英数字の羅列が「ファイルID」です!

3. STEP2:【実践】File.getDownloadUrl() で直リンクを取得してみよう!

それでは、GASのエディタを開いて実際のコードを動かしてみましょう!

1. コードを入力する

任意のGoogleスプレッドシート(または第1回で学んだスタンドアロンのGASエディタ)を開き、メニューの 「拡張機能」>「Apps Script」 を選択します。

エディタ画面のコードをすべて消去し、以下のコードを貼り付けてください。

function getPdfDownloadUrl() {
  // ① 操作したいPDFファイルのIDを指定する(※ご自身のファイルIDに置き換えてください)
  var fileId = "ここに取得したファイルIDを貼り付ける";
  
  // ② ファイルIDをもとに、DriveAppからファイルオブジェクトを取得する
  var file = DriveApp.getFileById(fileId);
  
  // ③ 通常の閲覧用URL(getUrl)を取得する
  var normalUrl = file.getUrl();
  
  // ④ ★本日の主役!直接ダウンロード用URL(getDownloadUrl)を取得する
  var downloadUrl = file.getDownloadUrl();
  
  // ⑤ 第1回で学んだ Logger.log でそれぞれのURLを出力して比較してみる
  Logger.log("■ ファイル名: " + file.getName());
  Logger.log("■ 通常のプレビューURL: " + normalUrl);
  Logger.log("■ ★直リンク(ダウンロードURL): " + downloadUrl);
}

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

  • var file = DriveApp.getFileById(fileId);
    Googleドライブ全体を管理する DriveApp(第41回参照)に対して、指定したIDのファイルを連れてくるよう命令しています。
  • var downloadUrl = file.getDownloadUrl();
    取得したファイルオブジェクトに対して .getDownloadUrl() を呼び出しています。これにより、末尾に &e=download などがついたダウンロード専用の特殊なURLが取得されます。

3. 保存して実行する

  1. エディタ上部の 「保存アイコン(フロッピーディスク)」 をクリックします。
  2. 実行する関数が getPdfDownloadUrl になっていることを確認し、「実行」 ボタンをクリックします。

⚠️ 初回実行時の「承認プロセス」が出たら?

初めてGoogleドライブを操作するスクリプトを実行する際は、「承認が必要です」というセキュリティポップアップが表示されます。第2回で解説した手順通り、「権限を確認」>「アカウント選択」>「詳細」>「安全ではないページに移動」>「許可」の順でアクセスを許可してくださいね!

4. 実行結果を確認する

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

情報    ■ ファイル名: 札幌観光マップ.pdf
情報    ■ 通常のプレビューURL: https://drive.google.com/file/d/1a2b3c4d5e.../view?usp=drivesdk
情報    ■ ★直リンク(ダウンロードURL): https://drive.google.com/uc?id=1a2b3c4d5e...&export=download

ログに出力された 直リンクURL をコピーして、ブラウザの新しいタブに貼り付けて開いてみてください。

ドライブの画面が開くことなく、即座にPDFファイルのダウンロードが開始されたはずです!

4. STEP3:実務で大活躍!getDownloadUrl() の応用パターン3選

ダウンロードURLを取得できるようになったら、他のGoogleサービスと組み合わせることで業務の自動化が一気に加速します。実務で使える3つの発展パターンをご紹介します!

応用①:スプレッドシートにダウンロードURLを自動書き込み

資料管理表などのスプレッドシートに、PDFのダウンロードURLを一覧として自動書き込みする処理です(第6回 setValue() や第7回 appendRow() との組み合わせ)。

function writeDownloadUrlToSheet() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var fileId = "ここにファイルID";
  var file = DriveApp.getFileById(fileId);
  
  var fileName = file.getName();
  var downloadUrl = file.getDownloadUrl();
  
  // シートの最終行に「ファイル名」と「ダウンロード直リンク」を追記!
  sheet.appendRow([fileName, downloadUrl, new Date()]);
  Logger.log("スプレッドシートに直リンクURLを書き込みました!");
}

応用②:Gmailで「観光マップPDF」のダウンロードURLを自動送信

出張者やイベント参加者へ向けて、メール本文にダウンロード直リンクを載せて送信します(第31回 GmailApp.sendEmail() との組み合わせ)。

function sendMapUrlViaEmail() {
  var fileId = "ここにファイルID";
  var file = DriveApp.getFileById(fileId);
  var downloadUrl = file.getDownloadUrl();
  
  var recipient = "example@example.com";
  var subject = "【札幌出張・観光】おすすめスポット案内PDFのご送付";
  var body = "お疲れ様です!\n\n"
           + "明日の札幌滞在に役立つ「観光マップPDF」のダウンロードリンクをお送りします。\n"
           + "以下のリンクをクリックすると、直接PDFが保存されます。\n\n"
           + "▼ ダウンロード直リンク:\n" + downloadUrl + "\n\n"
           + "気をつけてお越しください!";
           
  GmailApp.sendEmail(recipient, subject, body);
  Logger.log("ダウンロードURL付きメールを送信しました!");
}

メールを受け取った相手は、ドライブのログイン画面に迷うことなく、リンクをタップするだけで案内チラシをスマホに保存できます。

応用③:特定フォルダ内の全PDFのダウンロードURLを一括取得

「大通公園イベント用」フォルダ(第48回参照)に入っている複数の配布資料から、ダウンロードURLを一気に取得してログ出力する例です(第43回 Folder.getFiles() との組み合わせ)。

function listAllDownloadUrls() {
  var folderId = "ここにフォルダID";
  var folder = DriveApp.getFolderById(folderId);
  var files = folder.getFiles(); // フォルダ内の全ファイルを取得
  
  while (files.hasNext()) {
    var file = files.next();
    // PDFファイルのみを対象にする判定
    if (file.getMimeType() === "application/pdf") {
      Logger.log("ファイル名: " + file.getName());
      Logger.log("ダウンロードURL: " + file.getDownloadUrl());
      Logger.log("-----------------------------------------");
    }
  }
}

5. 初心者が絶対につまずく!4大トラップと完全対処法

File.getDownloadUrl() は非常に便利な命令ですが、いざ使ってみると「あれ?ダウンロードできない!」と壁にぶつかる人が少なくありません。初心者がハマりがちな4つのトラップと対策をまとめました。

トラップ1:共有設定(アクセス権限)が「非公開」のままになっている

【症状】

自分がURLをクリックするとダウンロードできるのに、メールで送った相手がクリックすると「アクセス権限が必要です」エラーになってしまう。

【原因と対策】

getDownloadUrl() で作成されるURLは、あくまで「ファイルの取得経路」を指定するものです。ファイル自体のGoogleドライブ共有権限を飛び越えることはできません。

不特定多数の人にダウンロードしてもらいたい場合は、事前にドライブ上でファイルの共有設定を 「リンクを知っている全員が閲覧可能」 に変更しておきましょう!

トラップ2:Googleドキュメントやスプレッドシートに対して実行してしまう

【症状】

GoogleドキュメントやGoogleスプレッドシートのファイルに対して getDownloadUrl() を実行すると、空文字が返ってきたり、期待した形式で保存できない。

【原因と対策】

getDownloadUrl() は、PDF、画像(JPEG/PNG)、ZIP、音声ファイルなど、ドライブにそのまま保存されているバイナリファイル(実体のあるファイル)用の命令です。

Google独自形式(DocやSheet)をPDF等としてダウンロードさせたい場合は、Google Apps Scriptでエクスポート用URLを組み立てるか、後日学ぶ Blob.getAs() を使ってPDF化する必要があります。

トラップ3:getUrl() と名前を混同してプレビューが開いてしまう

【症状】

直リンクを送ったつもりが、相手から「普通にドライブの画面が開いたよ」と言われてしまう。

【原因と対策】

コード内で .getUrl() を指定していないか確認しましょう!

  • .getUrl() ➡ ドライブ画面が開く
  • .getDownloadUrl() ➡ 直接ダウンロードされる

たった数文字の違いですが動きが全く異なりますので、タイポ(打ち間違い)に注意してくださいね。

トラップ4:ダウンロードURLの有効期限に注意

getDownloadUrl() で生成されるURLには、セッションやセキュリティの兼ね合いで内部的な仕様変更が入る場合があります。何年も前に生成したダウンロードURLをずっと使い回すのではなく、「メール送信や画面表示の都度、GASで動的に getDownloadUrl() を呼び出して最新URLを発行する」 組み方をしておくと安心です。

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

今回は、Googleドライブ内のファイルを直接ダウンロードさせる直リンクURLを取得する File.getDownloadUrl() について解説しました。

今日の重要ポイント

  1. getDownloadUrl() はプレビュー画面を挟まず、直接ダウンロードが始まるURLを取得する命令
  2. getUrl()(閲覧画面)と getDownloadUrl()(直接保存)の用途に合わせて使い分ける
  3. 相手に配布する場合は、ファイルの共有権限(「リンクを知っている全員」等)を忘れずに設定する
  4. PDF・画像・ZIPなどの実体ファイルに効果抜群!スプレッドシートやメール送信と組み合わせるとさらに便利

業務での資料配布や、観光ガイドの自動案内など、ユーザーの利便性を一気に高められるテクニックですので、ぜひご自身のスクリプトに取り入れてみてくださいね!

さて、ファイルを外部に案内できるようになったら、次に気になってくるのが「特定の同僚やチームメンバーにだけ、ファイルやフォルダの閲覧・編集権限を自動で付与したい!」 という権限管理の話ですよね。

次回(第50回)は、フェーズ5(Google Drive・ファイル管理)の締めくくりとして、ファイルへの閲覧権限を自動で付与する File.addViewer() × 「札幌エンジニア勉強会資料」に同僚の閲覧権限を自動付与 をお届けします!

権限追加の自動化をマスターして、ドライブ管理のプロを目指しましょう。お楽しみに!