前回(第57回)は、Googleドキュメントの請求書テンプレート内にある明細表のセル(TableCell)に対して、動的に作業データを流し込んだり、ヘッダー行の背景色をおしゃれに着色したりする方法を学びました。表データの入力ができるようになると、一気に実用的な書類らしくなってきましたね!
さて、請求書や見積書、契約書などのビジネス書類を完成させるにあたって、最後に絶対に欠かせない要素があります。そう、「会社印(社印・角印)」や「担当者印」の捺印です!
「書類のテキストや表は自動生成できたけれど、最後の社印画像だけは手動でGoogleドキュメントを開いてドラッグ&ドロップしてサイズを調整している…」なんてことになっていませんか?
第58回となる今回は、Googleドキュメントの本文に画像をプログラムから一瞬で挿入できる必須メソッド Body.appendImage() を徹底解説します!
札幌オフィスの請求書作成自動化プロジェクトを題材に、画像の取得方法から適切なサイズ調整の計算テクニック、さらには社印を思い通りの位置(表のセル内など)に配置する実践的な応用テクニックまで、どこよりも分かりやすく解説していきます!
1. そもそも Body.appendImage() とは?
Body.appendImage()(ボディ・アペンド・イメージ)は、Googleドキュメントの「本文(Body)」の末尾に、指定した画像データ(Blob)を自動で追加挿入するための命令(メソッド)です。
「家・部屋・家具」の例えで位置づけを復習しよう!
本連載でおなじみの「家・部屋・家具」の例えで、Googleドキュメント(Docs)の構造を整理してみましょう。
- 【家・建物】= Document(ドキュメント全体)
- 第51回で学んだ
DocumentApp.openById()で開くファイル全体です。
- 第51回で学んだ
- 【部屋】= Body(本文エリア)
- 第52回や第53回で学んだ
doc.getBody()で取得する、文字や表が置かれるメインの作業スペースです。
- 第52回や第53回で学んだ
- 【家具・飾り】= Paragraph(段落)、Table(表)、InlineImage(画像)★今回の主役!
- 部屋の中に配置される具体的な要素です。
Body.appendImage() は、まさにこの「部屋(Body)の一番奥(文書の末尾)に、新しい絵画や写真(InlineImage)を飾る操作」にあたります。
基本的なコードの文法
// 1. ドキュメントの本文(部屋)を取得する
var body = doc.getBody();
// 2. 本文の末尾に画像データ(Blob)を挿入する
var image = body.appendImage(imageBlob);
ここで戻り値として受け取れる image は、GASでは InlineImage(インライン・イメージ)オブジェクト と呼ばれます。この InlineImage オブジェクトを操作することで、挿入した画像の幅や高さを後から自由自在に変更することができます!
2. 画像データ「Blob(ブロブ)」ってなに?画像を取得する仕組み
appendImage() を使うにあたって、初心者が一番最初につまずきやすいのが、引数に渡す 「Blob(ブロブ)」 という概念です。
「Blob」はお手紙を入れた「封筒」のイメージ!
body.appendImage("C:\mypicture.png") のように、ファイルのパスやファイル名を直接渡してもGASは動いてくれません。
GASで画像を扱うときは、画像ファイルを Blob(Binary Large Object:バイナリ・ラージ・オブジェクト) という「プログラムが扱いやすい生のデータ形式(データが入った封筒)」に変換して渡す必要があります。
実務で画像を取得するルートは、主に以下の2パターンがあります。
【パターンA:Googleドライブから取得】
DriveApp.getFileById("ファイルID") ──> .getBlob() ──> appendImage() に渡す
【パターンB:Web上のURLから取得】
UrlFetchApp.fetch("画像のWeb URL") ──> .getBlob() ──> appendImage() に渡す
今回は実務で最もよく使われる「Googleドライブ上に保存した社印(角印)の画像ファイルを取得して挿入する」パターンを中心に進めていきますね!
3. STEP1:準備!「札幌オフィス請求書」と「角印画像」を用意しよう
まずは、実際にGASで動かすための練習用ファイルを用意しましょう。
手順1:Googleドライブに「社印(角印)画像」をアップロードする
- パソコンでテスト用の画像を用意します(透過PNG形式の印鑑画像や、ロゴ画像など何でもOKです)。
- Googleドライブを開き、画像をドラッグ&ドロップでアップロードします。
- アップロードした画像ファイルをダブルクリックで開き、画面右上の「縦の3点リーダー(⋮)」> 「新しいウィンドウで開く」 を選択します。
- アドレスバーのURLを確認し、以下の太字部分(
d/と/viewの間にある英数字の羅列)をコピーしておきます。これが「画像ファイルのID」です。
https://drive.google.com/file/d/1a2b3c4d5e6f7g8h9i0j-XXXXX/view
手順2:練習用のGoogleドキュメントを作成する
- Googleドライブで「新規」>「Googleドキュメント」をクリックします。
- ドキュメント名を 「札幌オフィス請求書_テスト」 に変更します。
- 本文に「ご請求書」や「株式会社札幌スープカレー本舗 御中」などの適当なテキストを入力しておきます。
- スプレッドシートの時と同様に、アドレスバーのURLから「ドキュメントのID」(
d/と/editの間の文字列)をコピーしておきます。
4. STEP2:【実践】ドキュメントに「角印画像」を挿入してみよう!
準備ができたら、さっそくGASのエディタを開いてコードを書いていきましょう!
1. コードを入力する
任意のGoogleスプレッドシートやスタンドアロンスクリプトの「Apps Script」エディタを開き、既存のコードをすべて消して以下を貼り付けます(ID部分はご自身のものに書き換えてください)。
function addCompanySeal() {
// ① ドキュメントIDと画像ファイルIDを指定する
var docId = "YOUR_DOCUMENT_ID_HERE"; // ご自身のドキュメントIDを入力
var imageFileId = "YOUR_IMAGE_FILE_ID_HERE"; // ご自身の画像ファイルIDを入力
// ② ドキュメント(家)と本文(部屋)を取得する(第51回参照)
var doc = DocumentApp.openById(docId);
var body = doc.getBody();
// ③ Googleドライブから社印の画像ファイルを取得し、Blob(データ)に変換する
var imageFile = DriveApp.getFileById(imageFileId);
var imageBlob = imageFile.getBlob();
// ④ 本文の末尾に画像を自動挿入する!
var inlineImage = body.appendImage(imageBlob);
// ⑤ 実行結果をログに出力する(第1回参照)
Logger.log("社印(角印)画像の挿入が正常に完了しました!");
}
2. 初回実行時の「承認プロセス」を許可する
コードを保存し、「実行」ボタンを押します。
初回実行時には、DocumentApp(ドキュメント操作)および DriveApp(ドライブファイル操作) のアクセス権限を求める警告ポップアップが表示されます。
第2回で解説した手順と同様に、「権限を確認」>「自分のアカウント選択」>「詳細」>「無題のプロジェクト(安全ではないページ)に移動」>「許可」 の順にクリックして承認してくださいね。
3. 実行結果を確認する
Googleドキュメントの画面に戻って確認してみましょう!
ドキュメント本文の一番最後の行に、指定した社印画像が自動で挿入されていれば大成功です!
5. STEP3:超重要!画像サイズを適切な大きさに調整しよう(setWidth / setHeight)
無事に画像が挿入できましたが、ドキュメントを見て「あれ…?画像がめちゃくちゃ大きくてページからはみ出そう!」「角印なのに画面半分を占める巨大印鑑になっちゃった!」と驚いた方も多いのではないでしょうか?
appendImage() で挿入される画像は、デフォルトでは元画像の解像度(ピクセル数)そのままの巨大サイズで配置されてしまいます。
請求書の角印であれば、一般的には 「縦横 60〜80ピクセル程度」 のコンパクトなサイズが最適です。ここからは、画像を思い通りのぴったりサイズに調整するテクニックを学びましょう!
画像の幅と高さを変更する命令
appendImage() の戻り値である InlineImage オブジェクトには、サイズ変更用のメソッドが用意されています。
// 幅を80ピクセルに設定する
inlineImage.setWidth(80);
// 高さを80ピクセルに設定する
inlineImage.setHeight(80);
アスペクト比(縦横比)を崩さずに綺麗に縮小するプロの計算テクニック!
正方形の印鑑画像なら setWidth(80); setHeight(80); で問題ありませんが、会社のロゴマークなど「横長の画像」の場合、幅と高さを適当な数値で指定すると、画像が縦や横にビヨーンと伸びて不自然に変形してしまいます。
そこで、元の縦横比(アスペクト比)を保ったまま、希望の幅に合わせて高さを自動計算させるプロのコード を覚えておきましょう!
function addResizedCompanySeal() {
var doc = DocumentApp.openById("YOUR_DOCUMENT_ID_HERE");
var body = doc.getBody();
var imageFile = DriveApp.getFileById("YOUR_IMAGE_FILE_ID_HERE");
var imageBlob = imageFile.getBlob();
// 1. 画像を挿入する
var image = body.appendImage(imageBlob);
// 2. 元の画像サイズ(幅・高さ)を取得する
var originalWidth = image.getWidth();
var originalHeight = image.getHeight();
// 3. 変更したい「幅(ピクセル)」を決める(例:幅80pxにしたい)
var targetWidth = 80;
// 4. 縮小・拡大の比率(倍率)を計算する
var ratio = targetWidth / originalWidth;
// 5. 比率をもとに「最適な高さ」を算出する
var targetHeight = originalHeight * ratio;
// 6. 計算した適切なサイズをセットする!
image.setWidth(targetWidth);
image.setHeight(targetHeight);
Logger.log("アスペクト比を維持したまま画像サイズを調整しました!(幅:" + targetWidth + "px, 高さ:" + targetHeight + "px)");
}
この計算式を入れておけば、どんな縦横比の画像であっても歪むことなく、狙った幅に美しくジャストフィットさせることができます!
6. STEP4:実務で差がつく応用!請求書の「差出人テーブル内」に社印を綺麗に配置する
実際の業務で使われる請求書では、本文の一番最後ではなく、画面右上や右下にある「発行元(札幌オフィス)情報」の横や後ろに社印を重ねるように押印したい場合がほとんどですよね。
第56回・第57回で学んだ「表(Table)」の特定のセル(TableCell)に対して画像を挿入すると、社印の位置がズレることなく完璧なレイアウトが作成できます!
function addSealToTable() {
var doc = DocumentApp.openById("YOUR_DOCUMENT_ID_HERE");
var body = doc.getBody();
// ドキュメント内にある「最初の表(Table)」を取得する
var table = body.getTables()[0];
// 表の「1行目・2列目(右側のセル)」を取得する(第57回参照)
// ※右側セルに「発行元:株式会社札幌スープカレー本舗...」が入っている想定
var cell = table.getCell(0, 1);
// 社印画像を取得する
var imageBlob = DriveApp.getFileById("YOUR_IMAGE_FILE_ID_HERE").getBlob();
// 【ポイント】Body ではなく セル(TableCell)に対して appendImage() を呼び出す!
var sealImage = cell.appendImage(imageBlob);
// サイズを角印サイズ(70px)に調整
sealImage.setWidth(70);
sealImage.setHeight(70);
Logger.log("請求書の差出人欄(セル内)へ社印の捺印が完了しました!");
}
このように、body.appendImage() だけでなく、cell.appendImage() や paragraph.appendImage() を使い分けることで、ドキュメント内の狙ったピンポイントの位置に画像を挿入できるようになります!
7. 初心者が絶対につまずく「5大トラップ」と完全対処法
Body.appendImage() を使う際、プログラミング初心者やGAS学習者がよく遭遇するエラーやトラブルを5つ厳選しました。ここでしっかり対処法を押さえておきましょう!
トラップ1:.getBlob() を忘れて Exception: Invalid argument になる
// ✕ エラーになる書き方(ファイルオブジェクトをそのまま渡している)
var file = DriveApp.getFileById(id);
body.appendImage(file);
// ◯ 正しい書き方(必ず .getBlob() でデータ化して渡す)
var blob = DriveApp.getFileById(id).getBlob();
body.appendImage(blob);
appendImage() はファイルの「入れ物(Fileオブジェクト)」ではなく、「中身の画像データ(Blob)」しか受け取れません。必ず末尾に .getBlob() をつけると覚えておきましょう!
トラップ2:画像が巨大化して2ページ目に追い出される
「実行したらドキュメントが突然2ページに増えてしまった!」という場合は、前述の通りデフォルトサイズで挿入された画像が大きすぎてページから溢れているのが原因です。
挿入した直後に、必ず image.setWidth() と image.setHeight() をセットで実行 する癖をつけましょう。
トラップ3:Cannot find method getTables などのタイポ(スペルミス)
GASのメソッド名は大文字と小文字を厳密に区別します。
- ✕
body.appendimage()(iが小文字) - ✕
body.AppendImage()(Aが大文字) - ◯
body.appendImage()(Iのみ大文字)
手入力によるスペルミスを防ぐため、キーボードの Ctrl + Space(Macは Option + Esc など)で表示される自動補完機能を活用しましょう。
トラップ4:画像が背景の後ろに隠れる・テキストと被らない
Googleドキュメントの仕様上、appendImage() で追加される画像は 「行内(InlineImage)」 オブジェクトとして扱われます。
手動操作のように「文字の背後に移動」「テキストを折り返す」といった自由なレイアウト配置(浮動画像)にする機能は、現在のGAS標準メソッドでは制限があるため、「表(Table)の枠線を使って配置場所をきれいに区画整理する」 のが実務でのベストプラクティスです。
トラップ5:Web上の画像URLから取得するときに Exception: Attribute provided... が出る
Web上の画像URLから UrlFetchApp.fetch(url).getBlob() で取得する場合、指定したURLがWebページ(HTML)のURLになっていると画像として認識されずエラーになります。
必ず画像の「直リンクURL(末尾が .png や .jpg で終わるURL)」 を指定しているか確認しましょう。
8. 今回のまとめと次回予告
今回は、Googleドキュメントに画像を自動挿入する Body.appendImage() の使い方と、サイズ調整・レイアウト配置のコツを学びました!
今日の重要ポイント
body.appendImage(blob)はドキュメントの本文末尾に画像(InlineImage)を追加する- Googleドライブの画像を使う際は、必ず
DriveApp.getFileById().getBlob()を通して Blob 形式にする - 挿入された画像は巨大化しやすいため、
setWidth()/setHeight()で適切なサイズ(角印なら60〜80px程度)に縮小する targetWidth / originalWidthで倍率を計算すれば、縦横比(アスペクト比)を崩さずに綺麗に縮小できる- 表のセル内に配置したい場合は
TableCell.appendImage()を活用する
これで、請求書のテキスト置換(第52回)、明細表の動的作成(第56回・57回)、そして社印(角印)の自動捺印(第58回)まで完ペキに揃いましたね!
次回(第59回)は、請求書のクオリティをさらに高める Document.addHeader() / addFooter() を解説します!
請求書のページ最下部(フッター)に「札幌オフィス問合せ窓口のご案内」や「ページ番号」を自動で差し込むテクニックを学んでいきましょう。次回もお楽しみに!
