ユーザーマニュアル

最終更新日: 2026年7月13日

概要

FormToPDF は Google Workspace™ 上で動作するアドオンです。

以下の流れで、スプレッドシートのデータをもとにした PDF を一括生成できます。

Google フォーム™ でデータを収集する
回答が Google スプレッドシート™ に保存される
アドオンのサイドバーから生成範囲を指定する
Google ドキュメント™ のテンプレートにデータが差し込まれ、自動的に PDF が生成される

補足: Google フォーム™を使うのが最も簡単な方法です。ただし、すでにスプレッドシートにデータが存在する場合は、そのデータをそのまま利用することも可能です。その場合、1行目を列名（ヘッダー行）としてください。

導入手順

1. Google フォーム™の作成

スプレッドシートにデータを蓄積するため、あらかじめ Google フォーム™を作成し、回答をスプレッドシートに保存する設定にしてください。Google フォーム™の「回答」タブから、回答保存先のスプレッドシートを指定できます。

2. 画像ファイルのアクセス権設定

フォームで画像ファイルの添付を許可している場合、アップロードされた画像ファイルのアクセス権設定が重要です。

重要: フォームでアップロードされた画像が保存される Google Drive™ のフォルダに対して、「リンクを知っている全員」を閲覧者に設定してください。

最も簡単な方法は、フォームの回答保存先フォルダ（フォームの回答に添付された画像が保存されるフォルダ）に対して「リンクを知っている全員」を設定することです。これにより、FormToPDF が画像をテンプレートに埋め込めるようになります。

3. アドオンのインストールと起動

Google Workspace™ Marketplace から FormToPDF アドオンをインストールしてください。

スプレッドシートを開く
メニューバーの「拡張機能」→「アドオン」→「アドオンを取得」からインストール
インストール後、「拡張機能」→「PDF出力」→「一括PDF生成」をクリック

詳しい起動方法はインストール後の使い方をご参照ください。

サイドバーの使い方

サイドバーでは以下の操作が行えます。

操作ボタン

開始: 指定した範囲の未処理行から PDF 生成を開始します
再開: 中断された生成処理を途中から再開します
初めから: すべての行を破棄して最初からやり直します
リカバリ: エラーが発生した行のみを再処理します

範囲指定

「開始行」と「終了行」で、PDF を生成する行の範囲を指定できます。

進捗表示

サイドバーには以下の情報がリアルタイムで表示されます。

処理済み行数
残り行数
エラー行数
生成可能回数（サブスクリプションの残り回数）
出力先フォルダへのリンク

プレースホルダー一覧

テンプレートドキュメント内に {{列名}} 形式のプレースホルダー（差し込み項目）を記述することで、スプレッドシートの各行のデータに置換できます。

列名プレースホルダー（推奨）

スプレッドシートの1行目（ヘッダー行）に定義された列名を使ってプレースホルダーを指定します。

例：スプレッドシートのヘッダー行に「氏名」「郵便番号」「住所」「備考」の列がある場合

拝啓
{{氏名}} 様

ご住所：{{住所}}
郵便番号：{{郵便番号}}

{{備考}}
敬具

列アルファベットプレースホルダー

{{A}} 〜 {{ZZ}}（1〜2文字の大文字アルファベット）で列を指定することもできます。

{{A}} 様

ご住所：{{C}}
郵便番号：{{B}}

列名と列アルファベットの優先順位

列名がたまたま A 〜 ZZ の1〜2文字の大文字アルファベットと重複する場合、列アルファベットとして解釈されます。

例：ヘッダーに A という列名がある場合、{{A}} は列アルファベットの「A列」として解決されます
それ以外の列名（日本語・数字を含む・3文字以上など）は列名プレースホルダーとして解決されます

全パラメータ一覧

パラメータ	説明	例
（なし）	セルの値をそのまま挿入	`{{氏名}}`
`:text`	表示形式を適用した値を挿入（日付の書式など）	`{{日付:text}}`
`:image[N]`	N番目の画像を挿入（0始まり）	`{{写真:image[0]}}`
`:image[N]:width:xx%`	N番目の画像をページ幅xx%で挿入	`{{写真:image[1]:width:50%}}`
`:qrcode`	セルの値をQRコード画像に変換	`{{URL:qrcode}}`
`:qrcode:size:xx`	サイズ指定でQRコード画像を生成	`{{URL:qrcode:size:80}}`
`:map:image`	住所を地図画像に変換（デフォルト設定）	`{{住所:map:image}}`
`:map:image:params`	任意パラメータで地図画像を取得	`{{住所:map:image:zoom=13&size=400x300}}`
`:map:qrcode`	住所をGoogle Maps検索URLのQRコードに変換	`{{住所:map:qrcode}}`
`:map:qrcode:size:xx`	サイズ指定で地図QRコードを生成	`{{住所:map:qrcode:size:80}}`
`:currency`	数値を3桁カンマ区切り＋「円」でフォーマット	`{{金額:currency}}`
`:currency:symbol:xx`	指定記号を前置して3桁カンマ区切りでフォーマット	`{{金額:currency:symbol:￥}}`
`:wareki`	日付値を和暦（元号年）形式に変換	`{{日付:wareki}}`
`:text:wareki`	表示値（文字列）をパースして和暦形式に変換	`{{日付:text:wareki}}`

画像プレースホルダー

画像を挿入するには {{列名:image[N]}} 形式を使用します。

{{写真:image[0]}}

[N]: セル内の複数画像から何番目を取得するか（0始まり）
セルの値には Google Drive™ の共有リンクを指定します。例：https://drive.google.com/open?id=1lE9Q14zEC9B1eeQruinuG4kBEWIZID4Y
複数画像を1つのセルにカンマ区切りで記載できます
Google フォーム™でファイルを添付した場合のセルは、そのまま利用可能です

画像の幅を指定する

画像の幅をページ幅に対するパーセンテージで指定するには :width:xx% パラメータを追加します。

{{写真:image[0]:width:50%}}

画像が用紙の横幅の50%にリサイズされます
:width を省略した場合は、従来通り横幅300ピクセルで表示されます
列アルファベット形式でも使用可能: {{A:image[0]:width:75%}}

QRコードプレースホルダー

セルの値をQRコード画像に変換して挿入するには {{列名:qrcode}} 形式を使用します。

{{URL:qrcode}}

指定された列のセル値をデータとしてQRコード画像を生成します
QRコードは外部API（api.qrserver.com）から取得します
デフォルトの画像サイズは200x200ピクセルです

QRコードのサイズを指定する

{{URL:qrcode:size:80}}

QRコード画像のサイズを80x80ピクセルに指定できます
列アルファベット形式でも使用可能: {{A:qrcode:size:80}}

地図QRコード

セルの値をGoogle Maps検索URLに変換し、そのURLのQRコード画像として挿入するには {{列名:map:qrcode}} 形式を使用します。

{{住所:map:qrcode}}

指定された列のセル値（住所）からGoogle Maps検索URLを生成し、そのURLをQRコード化します
外部QRコード生成API（api.qrserver.com）を使用します
デフォルトの画像サイズは200x200ピクセルです

地図QRコードのサイズを指定する

{{住所:map:qrcode:size:80}}

QRコード画像のサイズを80x80ピクセルに指定できます
列アルファベット形式でも使用可能: {{A:map:qrcode:size:80}}

QRコードのエラーハンドリング

表示	ケース
`No address data`	住所セルが空の場合
`QR API error: {code}`	QRコードAPI呼び出しが200以外のステータスを返した場合

注意: QRコード生成のためにセルの値が外部API（api.qrserver.com）に送信されます。機密情報をQRコード化する場合はご注意ください。

地図画像（Google Maps Static API）

セルの値をGoogle Maps Static APIで地図画像に変換して挿入するには {{列名:map:image}} 形式を使用します。

{{住所:map:image}}

指定された列のセル値を住所として、Google Maps Static APIから地図画像を取得します
デフォルトのズームレベルは15、画像サイズは600x400ピクセルです
指定住所に赤いマーカーピンが立てられます

地図のパラメータを指定する

{{住所:map:image:zoom=13&size=400x300}}

zoom=N: ズームレベルを指定（デフォルト: 15）
size=WxH: 画像サイズを指定（デフォルト: 600x400）
パラメータは Google Maps Static API にそのまま渡されます
列アルファベット形式でも使用可能: {{A:map:image:zoom=16}}

地図画像のエラーハンドリング

表示	ケース
`No address data`	住所セルが空の場合
`Maps API key not configured`	Google Maps Static API の API キーが設定されていない
`Maps API error: {code}`	API呼び出しが200以外のステータスを返した場合

注意: 住所が外部API（Google Maps Static API）に送信されます。機密情報を含む住所の場合はご注意ください。

テキスト表示値（TO_TEXT）プレースホルダー

セルの値をスプレッドシート上での表示形式（日付の書式、数値の書式など）を適用した状態で埋め込むには :text パラメータを使用します。

{{日付:text}}

日付列が「2024/1/1」と表示形式設定されている場合、{{日付}} では内部値が出力されますが、{{日付:text}} では「2024/1/1」と表示形式通りの値が出力されます
列アルファベット形式でも使用可能: {{A:text}}

通貨フォーマットプレースホルダー

セルの数値を3桁カンマ区切り＋通貨記号でフォーマットして出力するには {{列名:currency}} 形式を使用します。

{{金額:currency}}

プレースホルダー	入力値	出力
`{{金額:currency}}`	1000	1,000円
`{{金額:currency}}`	1000000	1,000,000円
`{{金額:currency}}`	0	0円
`{{金額:currency}}`	99.5	99.5円
`{{金額:currency}}`	-500	-500円

デフォルトの通貨記号は「円」で、数値の後ろに付与されます
数値以外の値が入力された場合は、そのままの値が出力されます
四捨五入は行わず、小数はそのまま保持されます
列アルファベット形式でも使用可能: {{A:currency}}

通貨記号を変更する

記号を「￥」などに変更するには :symbol:xx サブパラメータを使用します。

{{金額:currency:symbol:￥}}

プレースホルダー	入力値	出力
`{{金額:currency:symbol:￥}}`	1000	￥1,000

:symbol で指定した記号は数値の前に付与されます
列アルファベット形式でも使用可能: {{A:currency:symbol:￥}}

和暦変換プレースホルダー

セルの日付値を和暦（元号年）形式に変換して出力するには {{列名:wareki}} 形式を使用します。

{{日付:wareki}}

2026/7/11 → 令和8年7月11日
2019/5/1 → 令和元年5月1日
1989/1/8 → 平成元年1月8日
1926/12/25 → 昭和元年12月25日
1912/7/30 → 大正元年7月30日
1912/7/29 → 明治45年7月29日
1868/1/25 → 明治元年1月25日

対応元号: 明治（1868/1/25〜）、大正、昭和、平成、令和

1868/1/24 より前の日付はエラーとなります。

列アルファベット形式でも使用可能: {{A:wareki}}

テキスト表示値との組み合わせ

セルの表示値（文字列）をパースして和暦変換するには {{列名:text:wareki}} 形式を使用します。

{{日付:text:wareki}}

表示値が「2026/7/11」形式（YYYY/MM/DD）の場合に正しく変換されます
列アルファベット形式でも使用可能: {{A:text:wareki}}

バッチ生成

ステータス列（_FormToPDF_Status）

バッチ生成を実行すると、スプレッドシートに _FormToPDF_Status 列が追加され、各行の処理状態が記録されます。

未処理: まだPDFが生成されていない行
完了: PDFの生成が正常に完了した行
エラー: エラーが発生した行

スキップ列（_FormToPDF_Skip）

バッチ生成を実行すると、ステータス列のすぐ左に _FormToPDF_Skip 列が自動追加されます。この列に true（大文字小文字不問）と入力すると、バッチ処理時にその行のPDF生成がスキップされます。

空欄: 通常通り処理対象となります
true: その行はスキップされ、_FormToPDF_Status は変更されません
すでに _FormToPDF_Skip 列が存在する場合は再利用されます（既存の値は維持されます）
スキップした行は、値を空欄に戻して再度「バッチ準備」→「バッチ実行」することで処理できます

PDF列（Google Drive™リンク）

バッチ生成を実行すると、ステータス列のすぐ右に 「PDF」列 が自動追加されます。各行のPDF生成が成功すると、その行のPDF列に生成されたPDFファイルのGoogle Drive™リンクが書き込まれます。リンクをクリックするとブラウザで直接PDFを開くことができます。

すでにPDF列が存在する場合は再利用されます（既存のリンクは維持されます）
PDF生成がエラーになった行にはリンクは書き込まれません
過去に生成済みの行への遡及書き込みは行いません

ドキュメント列（Google Drive™リンク）

バッチ生成を実行すると、PDF列のすぐ右に「ドキュメント」列が自動追加されます。各行のPDF生成が成功すると、その行のドキュメント列に生成途中のGoogleドキュメントのリンクが書き込まれます。リンクをクリックするとブラウザで直接ドキュメントを開くことができます。

すでにドキュメント列が存在する場合は再利用されます（既存のリンクは維持されます）
ドキュメントはPDF変換後も残るため、後から内容の確認が可能です

重要: FormToPDFがマイドライブの画像を参照するためには「リンクを知っている全員」を閲覧者にしておく必要があります。フォームで画像が保存されるフォルダを「リンクを知っている全員」を閲覧者にするのが簡単です。

エラーメッセージ一覧

エラーケース	エラーメッセージ
空のプレースホルダー `{{}}`	「空のプレースホルダー「{{}}」は無効です。」
存在しない列名 `{{存在しない列}}`	「列名「存在しない列」はヘッダー行に存在しません。」
列アルファベット範囲外 `{{ZZZ}}`	列名として解決（ヘッダーに存在しなければ上記エラー）
データ範囲外の列アルファベット	「列アルファベット「X」（インデックス: 23）はデータ範囲外です（列数: 10）。」

料金・サブスクリプション

FormToPDF はサブスクリプション方式でご利用いただけます。Stripe を通じて決済が行われます。

	月額プラン	年額プラン（お得）
料金	300円/月	3,000円/年
支払い	月払い	年払い（月換算250円）

トライアルについて

初回はトライアルとして一定回数まで無料でお試しいただけます。トライアル期間・回数を超えた場合は、サブスクリプションにご登録いただくことで継続利用が可能です。

サブスクリプションの管理

Google Workspace™ Marketplace のマイアプリページから、FormToPDF の設定を開き、「サブスクリプションを管理」より解約手続きを行ってください。解約後は次回更新が行われず、既存の機能は契約期間中引き続きご利用いただけます。

よくある質問（FAQ）

画像が表示されない

画像がテンプレート内で表示されない場合、最も多い原因はアクセス権設定です。Google Drive™ 上の画像ファイルが「リンクを知っている全員」に設定されているかご確認ください。

フォームで画像が保存されるフォルダ全体に対して「リンクを知っている全員」の閲覧者設定を行うと、個別ファイルに設定する手間が省けます。

「列名「XXX」はヘッダー行に存在しません。」エラー

プレースホルダーに指定した列名が、スプレッドシートの1行目（ヘッダー行）に存在しない場合に表示されます。以下をご確認ください。

列名のスペル（全角/半角、大文字/小文字）が一致しているか
列名の前後に不要なスペースがないか
列名が1〜2文字の大文字アルファベット（A〜ZZ）の場合、列アルファベットとして解釈される可能性があります

QRコードが表示されない

以下の点をご確認ください。

対象のセルが空でないか
:qrcode または :map:qrcode の記述が正しいか
QRコードAPI（api.qrserver.com）が利用可能なネットワーク環境か

地図画像が表示されない

以下の点をご確認ください。

対象のセルが空でないか（空の場合は「No address data」と表示されます）
Google Maps Static API の設定が正しく行われているか（「Maps API key not configured」が表示される場合）

PDFの生成に失敗する

以下の点をご確認ください。

Google スプレッドシート™と Google ドキュメント™の両方が開かれているか
テンプレートのプレースホルダーがスプレッドシートの列名と一致しているか
ブラウザのポップアップブロックが有効になっていないか
画像ファイルのアクセス権が正しく設定されているか

生成可能回数が0になった

トライアルの利用上限に達したか、サブスクリプションの有効期限が切れている可能性があります。サブスクリプションをご契約いただくと、再度ご利用いただけます。

画像のアクセス権設定がめんどう

Google フォーム™の回答保存先フォルダ（フォームの「回答」タブで設定したスプレッドシートが保存されているフォルダ）に対して、「リンクを知っている全員」を閲覧者に設定するのが最も簡単な方法です。フォルダ単位で設定すれば、以降にアップロードされるすべての画像に自動的に適用されます。

詳細はサポートページもご参照ください。

メールの下書き Smart Chip の利用

テンプレートへの設定方法

テンプレートのGoogleドキュメント内で @メールの下書き と入力すると、Smart Chip（スマートチップ）として「メールの下書き」が挿入されます。このSmart Chipに以下のフィールドを設定することで、生成したドキュメントからワンクリックでGmailの送信画面を開くことができます。

To: {{メールアドレス}} — スプレッドシートのメールアドレス列を指定
件名: {{件名列}} — スプレッドシートの件名列を指定
本文: テンプレート内のプレースホルダーを使用して文章を記述

利用手順

テンプレートのGoogleドキュメントで @ を入力し、「メールの下書き」を選択
表示されたSmart Chipの各フィールドに、プレースホルダーを記述
通常通りバッチ生成を実行
生成された「ドキュメント」列のリンクをクリック
開いたドキュメントで M キーを押すか、Smart Chipにカーソルを合わせて「Gmailで開く」をクリック
プレースホルダーが解決された状態でGmailの送信画面が開きます