Googleドキュメント(Docs)をGASから操作する「フェーズ6:Google Docs操作編(第51回〜第60回)」も、ついに今回で最終回を迎えました!
第51回からスタートし、テンプレートの置換(第52回)、段落の追加(第53回)、明細表の挿入(第56回・57回)、角印画像の挿入(第58回)、ヘッダー・フッターの設定(第59回)と、着実に「札幌オフィスの請求書作成」をプログラムで組み立ててきましたね。
しかし!どれだけ綺麗に請求書ドキュメントが完成しても、Googleドキュメント(.gdoc)のままお客様に送るわけにはいきませんよね。 「うっかり編集されてしまうリスク」を避けるためにも、実務では「完成した請求書をPDF形式に変換し、Googleドライブの決まったフォルダーに保存する」という作業が絶対に必要になります。
そこで今回は、Googleドキュメントをワンクリックで美しいPDFファイルに変換し、ドライブに自動保存する決定版命令 Document.getAs('application/pdf') を徹底解説します!
初心者の方が一番つまずきやすい「Blob(ブロブ)」という謎の概念も、おなじみの例え話でスッキリ分かりやすく解説します。今回でDocs編を完全制覇しましょう!
1. そもそも Document.getAs(‘application/pdf’) とは?
Document.getAs('application/pdf') は、Google Apps Scriptで取得したGoogleドキュメントのデータを、指定したファイル形式(今回はPDF)データへ変換(出力)するための命令(メソッド)です。
コードの基本文法
// 1. 開いている Google ドキュメントを取得する
var doc = DocumentApp.getActiveDocument();
// 2. ドキュメントのデータを「PDF形式のデータ(Blob)」に変換する
var pdfBlob = doc.getAs('application/pdf');
ドット(.)でつないで doc.getAs('application/pdf') と呼び出すだけで、GAS内部で一瞬にしてPDFデータの状態にしてくれます。
理解の鍵!プログラミング用語「Blob(ブロブ)」ってなに?
GASでファイルをPDF化したりメール添付したりする際、どうしても避けて通れないのが 「Blob(ブロブ / Binary Large Object)」 という考え方です。
「ブロブ…?急に難しい単語が出てきた!」と身構える必要はありません。 「引っ越し用のダンボール箱」 をイメージしてみてください!
- Googleドキュメント(Docs) = 部屋に並んでいる本や衣類(いつでも編集できる状態のデータ)
.getAs('application/pdf')= 本や衣類を「PDF」というラベルを貼ったダンボール箱に綺麗に梱包する作業- Blob(ブロブ) = 荷造りが完了してテープで留められたダンボール箱(データのかたまり)
ドキュメントを .getAs('application/pdf') すると、中身が書き換えられないようにダンボール箱(Blob)にしっかりと梱包されます。 そして、その梱包されたダンボール箱を DriveApp.createFile(pdfBlob)(第42回参照)を使ってGoogleドライブの指定フォルダーへ置くことで、初めて「PDFファイル」として保存される仕組みになっているのです!
MimeType.PDF と 'application/pdf' の違いは?
コードを書くときに、以下の2通りの書き方を見かけることがあります。
// パターンA:文字列で指定する(今回のテーマ)
var pdfBlob = doc.getAs('application/pdf');
// パターンB:MimeType(マイムタイプ)という定数で指定する
var pdfBlob = doc.getAs(MimeType.PDF);
「どっちを使えばいいの?」と迷ってしまうかもしれませんが、結論から言うとどちらを書いても全く同じ動作をします!
'application/pdf' は「PDFファイルを指す世界共通の識別記号(MIMEタイプ)」です。 GASでは MimeType.PDF というショートカット記法も用意されていますが、今回は基本となる 'application/pdf' で解説を進めていきますね。
2. STEP1:準備!「請求書PDF保存用フォルダー」を用意しよう
それでは、実際に手元のGoogleドライブとGASを使ってPDF変換を試してみましょう!
今回は、札幌オフィスの経理業務を想定し、「完成したPDFを保存するためのGoogleドライブフォルダー」 を1つ用意します。
手順
- Googleドライブを開く ブラウザで Googleドライブ を開きます。
- 新しいフォルダーを作成する 画面左上の「+ 新規」>「新しいフォルダー」をクリックし、フォルダー名を 「札幌オフィス_請求書PDF保管庫」 にして作成します。
- フォルダーIDを取得する(超重要!) 作成したフォルダーを開き、ブラウザのURL欄 を確認します。
https://drive.google.com/drive/folders/1abc123XYZ_example_FolderID_999
folders/ の後ろに並んでいる 英数字の組み合わせ(例: 1abc123XYZ_example_FolderID_999) が、そのフォルダー固有の「フォルダーID」です。このIDをコピーしておきましょう!(※第41回 DriveApp.getFolderById() で使った知識ですね!)
3. STEP2:【実践】GoogleドキュメントをPDFに自動変換してDriveに保存しよう!
準備ができたら、第51回〜第59回で作ってきた Googleドキュメントのエディタ、または新規作成したドキュメントを開いてGASを実行してみましょう。
1. スクリプトエディタを開いてコードを入力する
ドキュメントの上部メニュー 「拡張機能」 > 「Apps Script」 を開き、エディタ画面のコードをすべて消して以下のプログラムを貼り付けます。
※ YOUR_FOLDER_ID_HERE の部分には、先ほど取得したご自身のフォルダーIDを貼り付けてください。
function convertDocToPdfAndSave() {
// ① 操作対象の Google ドキュメント(札幌オフィス請求書)を取得する
var doc = DocumentApp.getActiveDocument();
// ② 保存先の Google ドライブフォルダーを ID で取得する(第41回参照)
var folderId = "YOUR_FOLDER_ID_HERE"; // ご自身のフォルダーIDに置き換えてください
var folder = DriveApp.getFolderById(folderId);
// ③ ドキュメントの変更内容を確定させて最新状態にする(おまじない)
doc.saveAndClose();
// ④ ドキュメントを PDF データ(Blob)に変換する ★今回の主役!
var pdfBlob = doc.getAs('application/pdf');
// ⑤ PDF ファイルに分かりやすいファイル名をセットする
pdfBlob.setName("【請求書】札幌オフィス_株式会社北海道スープカレー様.pdf");
// ⑥ 指定したドライブフォルダー内に PDF ファイルを新規作成・保存する(第42回参照)
var pdfFile = folder.createFile(pdfBlob);
// ⑦ 完了ログと作成された PDF の URL を出力する(第1回・第49回参照)
Logger.log("PDFの自動変換と保存が成功しました!");
Logger.log("保存先ファイルURL: " + pdfFile.getUrl());
}
2. 保存して実行する
- エディタ上部の 「保存(フロッピーディスクのマーク)」 をクリックします。
- 実行する関数が
convertDocToPdfAndSaveになっていることを確認し、「実行」 をクリックします。 - 初回実行時はGoogleからの「承認プロセス(セキュリティ権限の確認)」が出ますので、画面の指示に従って許可を出してください(※第2回の承認手順を参照)。
3. 実行結果を確認してみよう!
処理が完了すると、エディタ下部の「実行ログ」に以下のように表示されます。
情報 PDFの自動変換と保存が成功しました!
情報 保存先ファイルURL: https://drive.google.com/file/d/1xxx.../view?usp=drivesdk
Googleドライブの「札幌オフィス_請求書PDF保管庫」フォルダーを開いてみてください。
「【請求書】札幌オフィス_株式会社北海道スープカレー様.pdf」というファイル名で、レイアウトの崩れていない綺麗なPDFファイルがバッチリ生成されていれば大成功です!
4. STEP3:コードの1行ずつ徹底分解解説!
初心者がつまずかないよう、今回登場した重要な処理を1行ずつ丁寧に解説します。
doc.saveAndClose(); (超重要な「おまじない」)
doc.saveAndClose();
実は、GASでドキュメントの文字を置換したり(第52回)、表を追加したり(第56回)した直後は、まだメモリ上に変更データが残っており、Googleドキュメント本体へ完全に反映(保存)されていない ことがあります。
そのまま .getAs('application/pdf') を呼び出すと、「テキストを置換する前の古い状態」がPDF化されてしまうという事故が起きます。
doc.saveAndClose() を一度挟むことで、「ここまでの編集内容をすべてドキュメントに上書き保存して一度閉じる」 という命令が出され、最新の状態で確実にPDF化できるようになります!
var pdfBlob = doc.getAs('application/pdf');
var pdfBlob = doc.getAs('application/pdf');
先ほど解説した通り、ドキュメントの内容をPDF形式というダンボール箱(Blob)に梱包する処理です。
pdfBlob.setName("ファイル名.pdf");
pdfBlob.setName("【請求書】札幌オフィス_株式会社北海道スープカレー様.pdf");
デフォルトのままだと、PDFのファイル名は元になったGoogleドキュメントと同じ名前(例:「無題のドキュメント」など)になってしまいます。
Blobに対して .setName() を使うことで、ドライブに保存される前の段階でPDFのファイル名を自由に変更 できます。
var pdfFile = folder.createFile(pdfBlob);
var pdfFile = folder.createFile(pdfBlob);
第42回 Folder.createFile() の復習ですね! 梱包されたダンボール箱(Blob)を、指定したDriveフォルダー(folder)の中に配置して、正式なPDFファイルとして書き出します。
5. STEP4:実務で差がつく!応用テクニック3選
単にPDF化するだけでなく、実務で毎日使える「プロの現場での応用パターン」を3つご紹介します!
応用①:今日の日付や請求先名を入れた「動的ファイル名」で保存する
ファイル名を毎回コード内に直接書く(ハードコーディングする)のではなく、実行した日付などを自動で組み込んだファイル名にしましょう!
function createDynamicPdfName() {
var doc = DocumentApp.getActiveDocument();
var folder = DriveApp.getFolderById("YOUR_FOLDER_ID_HERE");
// 今日の日付を「20260923」のような形式で取得する(第29回参照)
var today = Utilities.formatDate(new Date(), "JST", "yyyyMMdd");
var clientName = "札幌スープカレー本舗"; // 本来はシートやドキュメントから動的取得
doc.saveAndClose();
var pdfBlob = doc.getAs('application/pdf');
// 例:「20260923_請求書_札幌スープカレー本舗様.pdf」というファイル名を作る
var fileName = today + "_請求書_" + clientName + "様.pdf";
pdfBlob.setName(fileName);
folder.createFile(pdfBlob);
Logger.log("動的ファイル名でPDFを保存しました: " + fileName);
}
このように日付(第29回 Utilities.formatDate)を頭に付けることで、フォルダー内で名前順に並べたときに自動的に日付順で綺麗に整理されます。
応用②:PDF化した後、作業用の一時ドキュメント(Docs)を自動削除する
テンプレートからコピーして作った作業用のGoogleドキュメント(.gdoc)は、PDFさえ作成できればもう不要になることが多いですよね。 放置しておくとGoogleドライブが「無題のドキュメント」や「コピー」で散らかってしまいます。
そこで、第47回 File.setTrashed() を使って、PDF生成後に元のドキュメントを自動でゴミ箱へ移動させるスマートな処理 を組み込みましょう!
function convertAndCleanUp() {
var doc = DocumentApp.getActiveDocument();
var docId = doc.getId(); // ドキュメントの ID を取得
var folder = DriveApp.getFolderById("YOUR_FOLDER_ID_HERE");
doc.saveAndClose();
// 1. PDF に変換して Drive に保存
var pdfBlob = doc.getAs('application/pdf');
pdfBlob.setName("【完成版】札幌オフィス請求書.pdf");
folder.createFile(pdfBlob);
// 2. 元になった作業用 Google ドキュメントをゴミ箱へ移動(第47回参照)
var originalFile = DriveApp.getFileById(docId);
originalFile.setTrashed(true);
Logger.log("PDFの作成が完了したため、一時Docsファイルをゴミ箱へ移動しました。");
}
これでDrive内に無駄な中間ファイルが残らず、いつでもクリーンな状態を保てます!
応用③:作成したPDFをそのままGmailで顧客に自動送信する
第32回 GmailApp.sendEmail() と組み合わせれば、「請求書ドキュメント作成 ➡ PDF化 ➡ 相手へメール自動送信」 という完全自動化ラインが完成します!
function convertAndSendEmail() {
var doc = DocumentApp.getActiveDocument();
doc.saveAndClose();
// 1. PDF Blob を作成
var pdfBlob = doc.getAs('application/pdf');
pdfBlob.setName("請求書_札幌オフィス.pdf");
// 2. 送信先とメール本文の設定
var recipient = "example-client@example.com";
var subject = "【札幌オフィス】ご請求書送付のご案内";
var body = "お世話になっております。札幌オフィスの担当です。\n\n今月分の請求書をPDFにて添付いたしましたので、ご査収のほどよろしくお願い申し上げます。";
// 3. attachments オプションに PDF Blob を渡してメール送信!(第32回参照)
GmailApp.sendEmail(recipient, subject, body, {
attachments: [pdfBlob]
});
Logger.log("PDF請求書を添付してメールを送信しました!");
}
わざわざ一度パソコンにPDFをダウンロードして、Gmailの添付ボタンを押して…という手作業がすべてゼロになります!
6. STEP5:初心者が絶対につメインでつまずく「5大トラップ」と完全対処法
Document.getAs('application/pdf') を使う際、プログラミング初心者の方が非常によく直面するトラブルと対処法を5つまとめました。
トラップ1:TypeError: doc.getAs is not a function と怒られる
【原因】
doc 変数に入っているのが Document(ドキュメントオブジェクト)ではなく、ファイルIDや別のデータになっている場合に発生します。
【解決策】
doc を取得する際に、ちゃんと DocumentApp.getActiveDocument() や DocumentApp.openById(id) を使っているか確認しましょう。
// ✕ 間違い(DriveAppで取得した File オブジェクトに対して getAs を読もうとしている場合など)
var file = DriveApp.getFileById(id);
// ◯ 正しい(DocumentApp で開いたドキュメントに対して呼ぶ)
var doc = DocumentApp.openById(id);
var pdfBlob = doc.getAs('application/pdf');
トラップ2:PDFの中身が直前の変更(文字置換や表挿入)前の古い状態になっている
【原因】
doc.saveAndClose() を呼び出さずに .getAs('application/pdf') を実行したため、変更が保存される前の状態のままPDF化されてしまっています。
【解決策】
.getAs('application/pdf') を実行する直前に、必ず doc.saveAndClose(); を1行挟む ようにしてください!
トラップ3:PDF化したらページ数が勝手に増えてレイアウトが崩れた
【原因】
GoogleドキュメントからPDFへ変換する際、フォントサイズや行間、表(テーブル)の余白設定によっては、ドキュメント上では1ページに収まっていたものが2ページ目に溢れてしまう ことがあります。
【解決策】
- テンプレート側のフォントサイズを1ポイント小さく(例:11pt ➡ 10.5pt)設定しておく。
- 第55回で学んだ
setFontSize()や、第59回で学んだ余白調整を活用して、少し余裕を持ったレイアウト設計にしておくのがコツです。
トラップ4:'application/pdf' のスペルミス(タイポ)
【原因】
'applicaion/pdf' や 'application/PDF'(大文字小文字の間違い)など、文字列の打ち間違いによるエラーです。
【解決策】
手入力せずに本記事のコードからコピペするか、GASが用意している定数 MimeType.PDF を使用するとスペルミスを100%防げます。
トラップ5:DriveAppの権限エラーで保存できない
【原因】
初回実行時に「Googleドライブへのアクセス権限」の許諾を承認していないか、間違えたアカウントで実行している場合に発生します。
【解決策】
実行時に表示されるポップアップで「詳細」>「安全ではないページに移動」をクリックし、Googleドライブへのアクセスを許可(Allow)してください。
7. 今回のまとめ&次回予告
今回は、完成したGoogleドキュメントをPDF形式に自動変換してGoogleドライブに保存する Document.getAs('application/pdf') を解説しました!
今日の重要ポイントおさらい
doc.getAs('application/pdf')でドキュメントをPDF形式のBlob(ダンボール箱)に梱包できる!- PDF化の前には必ず
doc.saveAndClose()を実行して最新状態を確定させる! pdfBlob.setName("名前.pdf")で保存されるPDFのファイル名を自由に変更できる!DriveApp.getFolderById().createFile(pdfBlob)で目的のフォルダーへ保存する!GmailApp.sendEmail()やFile.setTrashed()と連携すると実務の自動化が爆速になる!
🎉 フェーズ6「Google Docs操作編」完結!
第51回から始まったGoogle Docs編(第51回〜第60回)は、今回で見事に全10回を走破しました!
- テンプレートを開き(第51回)
- 文字を置換し(第52回)
- 段落や表、画像を動的に組み立て(第53回〜58回)
- ヘッダー・フッターを整え(第59回)
- 最後に綺麗なPDFとして保存・出力する(第60回)
これで、みなさんは「Googleドキュメントを使ったあらゆる書類作成業務」をGASで完全自動化できるスキルを手に入れました!本当に素晴らしい進歩です!
次回予告:フェーズ7「Google Slides(スライド)操作編」へ突入!
次回からは、いよいよ新しい章「フェーズ7:Google Slides(スライド)操作編(第61回〜第75回)」がスタートします!
社内プレゼン資料、月次業績レポート、セミナー資料などの「スライド作成」も、GASを使えばスプレッドシートのデータから一瞬で自動生成できるようになります。
第61回は、SlidesApp.openById() をお届けします!
