🧩 Google Apps Script入門：ドキュメントをPDFに変換するしくみ

🎯 はじめに

前回の記事では、DocumentApp を使ってGoogleドキュメントを自動作成しました。
今回はその続きとして、作成したドキュメントをPDFに変換してGoogleドライブに保存する仕組みを学びます。

コードを書く前に、まずは 「どんな流れで動いているのか」 を理解しておきましょう。

---

🧰 1. 今回使うツール箱（サービス）

ツール箱（サービス）	できること	例えるなら…
DriveApp	Googleドライブ内のファイル操作	ファイル管理の道具箱
DocumentApp	Googleドキュメントの作成・編集	前回使った文書作成の道具箱

💬 今回はこのうち、DriveApp（ドライブを扱うツール箱） をメインで使います。

---

🧠 2. 全体の流れ（ざっくりイメージ）

1. 「かんたんレポート」という名前のドキュメントをGoogleドライブ内から探す
2. 見つかったら、そのドキュメントをPDFデータに変換する
3. 変換したPDFをドライブに保存する
4. 保存したPDFのURLをログに出力する

---

⚙️ 3. 使用する主な「道具」と「命令」

ツール箱	道具（クラス）	命令（メソッド）	役割
DriveApp	FileIterator（ファイル検索用の道具）	.searchFiles()	条件に合うファイルを検索する
DriveApp	File（ファイルを表す道具）	.createFile()	新しいファイルを作成する
File	Blob（ファイルデータを一時的に持つ道具）	.getAs()	PDF形式などに変換する
File	File（PDFファイル本体）	.setName()	名前を変更する

---

🔍 4. 処理の流れを図で見る

🧰 DriveApp（ドライブのツール箱）
   ├─ 🔎 searchFiles() → FileIterator（検索結果のかご）
   │     └─ next() → File（見つかったドキュメント）
   │           ├─ getAs("application/pdf") → Blob（PDFデータ）
   │           ├─ setName("タイトル.pdf")
   │           └─ createFile() → 新しいPDFファイルをDriveに保存

---

💬 5. 処理のポイント解説

① ファイルを探す

DriveApp.searchFiles('title = "かんたんレポート" and mimeType = "application/vnd.google-apps.document"');

• DriveApp というツール箱に「ファイルを検索する」命令を出しています。

• "mimeType" はファイルの種類を表します。

  • Googleドキュメントの場合 → "application/vnd.google-apps.document"

---

② 見つからないときの対応（ガード文）

if (!it.hasNext()) {
  Logger.log("Docなし：先に createDoc_simple() を実行してください");
  return;
}

• ファイルが見つからなかった場合にエラーにならないよう、早めに処理を止めています。
• it.hasNext() は「検索結果に次のファイルがあるか？」を確認する命令です。

---

③ PDFデータに変換して保存

const pdfBlob = docFile.getAs("application/pdf").setName(TITLE + ".pdf");
const pdfFile = DriveApp.createFile(pdfBlob);

• .getAs("application/pdf")
  → ドキュメントをPDFデータ（Blob）に変換する。
• .setName()
  → 出力するPDFのファイル名を変更する。
• .createFile()
  → そのPDFをドライブ上に新しいファイルとして保存する。

---

④ ログにURLを出力

Logger.log("PDF作成: " + pdfFile.getUrl());

• 保存したPDFのURLをログに出して確認できるようにしています。
• 「表示 → ログ」で開くとURLが見えます。

---

🧩 6. 用語の整理（今回のまとめ）

概念	やさしい説明	例
DriveApp	Googleドライブを操作するツール箱	ファイル検索・作成・削除など
FileIterator	検索結果を順番に取り出すかご	.hasNext(), .next() など
File	実際のファイルを扱う道具	.getAs(), .setName() など
Blob	一時的なデータの塊（ファイル内容）	PDF変換などに使用
Logger.log()	実行結果を確認するログ出力	コンソールにURLを出す

---

🪜 7. ここまでの理解を整理しよう

ステップ	やっていること	主なツール箱・道具
①	ファイルを探す	DriveApp + FileIterator
②	ファイルを取得	File
③	PDFに変換	File → Blob
④	保存してURLを出力	DriveApp + File

---

🎓 おわりに

今回のポイントは、**「DriveAppというツール箱を使って、ドキュメントをPDFに変換する流れ」**を理解することです。

🧰 DriveApp = Googleドライブを操作するツール箱
🛠 File・Blob = ファイルやデータを扱う道具
⚙ searchFiles()・getAs()・createFile() = 命令

このイメージを持っておくと、
次に「Gmailで送信する」「フォルダに移動する」などの応用操作も自然に理解できるようになります。

---

💡 補足：
この処理は「PDF化したいドキュメントがすでに存在していること」が前提です。
まだ作成していない場合は、先に createDoc_simple() を実行してから試しましょう。

---