【保存版】GASからGoogleフォームを作成する方法を徹底解説!

皆さん、普段Googleフォームは使いますか?
イベントの参加確認、課題提出、アンケート提出等…Googleフォームには、色々な活用方法がありますよね

今回は、Googleフォームで提供している各種フォーム項目をGAS側からいじくってみようかと思います!

こーすけ先生

全項目を取り扱うので、本記事をチートシートとして活用してください!

本記事の内容
  • GASからGoogleフォームを作成する方法を徹底解説
  • Googleフォームにおける各項目ごとの質問作成方法を解説
こーすけ先生

いや、Googleフォームを手動で作成すればよくない?と思ったあなた!
GASで作成すべき場面について例を挙げて解説します

この記事を読めば、GASからGoogleフォームを作成する方法を学ぶことができます!めちゃくちゃ便利なので、是非読んでいってください!

この記事の執筆者について
  • GASの人
  • ITベンダSEとして12年勤務する中で民間、金融、官公庁の現場を一通り経験済
  • 現在は公務員をやりながら起業に向けて着々と準備中
GASなら任せろ!

​GASを極めたい方や、業務の効率化を図りたい方は、ぜひこの記事を読んください!
難しいことはGASに任せて、我々人間は楽しちゃいましょう!

こーすけ先生

当ブログでは実際に仕事でGASを扱っている私が、GASの魅力について徹底的に取り上げていきます!

目次

GASからGoogleフォームを作成する理由

がすぴょん

ぶっちゃけ普通にGoogleフォームから質問項目を作った方が早くない?

こーすけ先生

普通の用途で作る場合はその方が早いかもしれないね

しかし、Google Apps Script(GAS)でGoogleフォームを作成した方が効率が良い場合があります

こーすけ先生

過去に体験した案件で、GASでGoogleフォームを作成&管理せざるを得ないケースがありました

過去の案件の詳細は伏せますが、ざっくり言うとA社は毎月新しい講座を開講する中で、異なる講座ごとに欠席届のフォームが必要でした。この要望を実現するために、「GAS×スプレッドシート×Googleフォーム」をフル活用し、フォームを自動生成する仕組みを作りました。

過去の案件を例に出すと、A社の職員さんがスプレッドシート上に受講者名やコースキーを入力することで、その情報を元に、GAS側で自動的に新しい講座ごとにフォームを生成するという仕組みを作りました

こーすけ先生

定期的に発生するフォーム作成を手動で行うのは面倒ですよね!
その場合、自動作成できるGASを活用した方が良いケースは多々あります

がすぴょん

なるほど!実例を聞くと納得!
僕もGASからGoogleフォームを作れるようになりたい!

このような自動化によって、GUIで手動でフォームを作成する手間や、特定の講座ごとにフォームの新規作成が必要な場合の手間が省けるだけでなく、プロセスのミスも軽減されます

特に、セクションの分岐などを含む複雑な構造を持つフォームを効率的に作成する際には、GASで自動化しちゃった方が早いし正確だし良いことづくめです

こーすけ先生

GASを使用してGoogleフォームを作成することには、定型業務のバッチ化と作業の合理化という大きなメリットがあります

「なんでGASからGoogleフォームを作る必要があるの?」という疑問が解消されたところで、早速、本題に入っていきましょう!

Googleフォームにおける各項目ごとの質問作成方法

本記事で取り組む演習
  • Googleフォームにおける各項目ごとの質問作成方法を解説

あの項目はどうやっていじるんだ?と疑問に思ったときはこのチートシート(本記事)を活用してください

Googleフォームは単なる質問受付に使えるだけではなく、フォーム自体をテストとして扱い、自動採点やフィードバックを行うこともできる非常に強力なツールです

とはいえ、本チートシートでは主たる用途である質問受付に特化してお伝えします

事前準備

今回のいじくり先のフォームを作成していきましょう

こーすけ先生

項目は空で構いません!
GAS側でどんどん項目を追加していきます

準備したGoogleフォームからコンテナバインド型でGASプログラムを記述していきましょう

こーすけ先生

Googleフォームからコンテナバインド型のGASを開く場合は、こちらを参考にしてください

チートシートについて

こーすけ先生

チートシートに記載の内容は、以下を併せて確認すると理解が深まります

Googleフォームの設定項目は非常に多いです
「回答者のメールアドレスを収集するか」や「クイズ形式とするか(いわゆるテストモード)」、「回答時の確認メッセージ」「受付をクローズとするか」など、多岐にわたります

フォームに対する設定

こーすけ先生

本チートシートでは代表的な以下の5点を設定する方法をお伝えします

スクロールできます
メソッド名 説明
setTitle(title)フォームのタイトルを設定します
setDescription(description)フォームの説明を設定します
setConfirmationMessage(message)フォームの確認メッセージを設定します
setCustomClosedFormMessage(message)フォームが回答を受け付けていない場合に表示するメッセージを設定します
setAcceptingResponses(enabled)フォームが現在回答を受け付けているかどうかを設定します
const form = FormApp.getActiveForm();
form.setTitle('ガスログ_項目の新規作成')
    .setDescription('このフォームはガスログにおいて、項目の新規作成を説明するためのものです。')
    .setConfirmationMessage('回答を受け付けました。')
    .setCustomClosedFormMessage('回答は現在受け付けておりません。')
    .setAcceptingResponses(true);

フォーム内の項目を一括削除

const form = FormApp.getActiveForm();
form.getItems().forEach(function(item){
  form.deleteItem(item);
});

フォーム内の項目を一部削除

こーすけ先生

何をもとに項目を判断するかは任意で決めてよいですが、一般的には項目タイトルがやりやすいと思います

const form = FormApp.getActiveForm();
form.getItems().forEach(function(item){
  if (item.getTitle()=='削除したい項目名') {
    form.deleteItem(item);
  }
});

共通事項

GoogleフォームにGASから項目を追加、更新する場合は、前回の記事で触れたように、addXXXXItem()とするかasXXXXItem()とし、項目を生成します

その際に、全項目に共通して使われるのが以下の3つのメソッドとなります

スクロールできます
メソッド名 説明
setTitle(title)フォームのタイトルを設定します
setHelpText(text)項目の説明文を設定します
setRequired(enabled)項目が回答必須かどうかを設定します。
※本項目はレイアウト要素(セクションヘッダーや画像項目等)には不要です

記述式

こーすけ先生

上記項目を作るには以下のようにGASを記述します

const form = FormApp.getActiveForm();
let textValidation_number = FormApp.createTextValidation()
                                   .requireNumber()
                                   .setHelpText('数字で入力してください。')
                                   .build();

form.addTextItem().setTitle('記述式の質問項目')
                  .setHelpText('記述式の質問項目に対する説明文')
                  .setValidation(textValidation_number)
                  .setRequired(true);
こーすけ先生

記述式の場合には、記載した内容に対する検証を行うことができます

上記の場合はrequireNumberを用いたため数値であるかどうかを判断しています
その他には以下のようなものがあります

スクロールできます
メソッド名 説明
requireNumber()アイテムは数値にする必要があります
requireNumberBetween(start, end)アイテムは、開始から終了までの範囲内の数値(両端を含む)にする必要があります
requireNumberGreaterThan(number)アイテムは、指定した値より大きい数値である必要があります
requireTextIsEmail()アイテムはメールアドレスである必要があります
requireTextMatchesPattern(pattern)パターン(正規表現)に一致するレスポンスが必要です
こーすけ先生

全メソッドを確認する場合は以下をチェック!

段落

const form = FormApp.getActiveForm();
let paragraphtextValidation_length = FormApp.createParagraphTextValidation()
                                            .requireTextLengthGreaterThanOrEqualTo(100)
                                            .setHelpText('少なくとも100文字以上入力してください。')
                                            .build();

form.addParagraphTextItem().setTitle('段落の質問項目')
                           .setHelpText('段落の質問項目に対する説明文')
                           .setValidation(paragraphtextValidation_length)
                           .setRequired(true);


段落の場合には、記載した内容に対する検証を行うことができます
上記の場合は、requireTextLengthGreaterThanOrEqualToを用いたため最小入力文字数を制限しました

こーすけ先生

その他には以下のようなものがあります

スクロールできます
メソッド名 説明
requireTextContainsPattern(pattern)パターンを含むレスポンスが必要です
requireTextDoesNotContainPattern(pattern)パターンが含まれていないレスポンスが必要です
requireTextDoesNotMatchPattern(pattern)パターンに一致しないレスポンスが必要です
requireTextLengthGreaterThanOrEqualTo(number)レスポンスの長さはこの値以上である必要があります
requireTextLengthLessThanOrEqualTo(number)レスポンスの長さは値より短くする必要があります
requireTextMatchesPattern(pattern)パターンに一致するレスポンスが必要です

ラジオボタン

こーすけ先生

上記項目を作るには以下のようにGASを記述します

const form = FormApp.getActiveForm();
form.addMultipleChoiceItem().setTitle('ラジオボタンの質問項目')
                            .setHelpText('ラジオボタンの質問項目に対する説明文')
                            .setChoiceValues(['選択肢1', '選択肢2', '選択肢3'])
                            .showOtherOption(true)
                            .setRequired(true);


ラジオボタンの場合には、showOtherOptionを用いることで 「その他」の選択肢を追加することができます

また、String配列による選択肢追加のsetChoiceValues とは別にChoice(単一の選択肢をサポート)配列によるsetChoices もあります

setChoices を扱うと、選択した場合に次セクションを分岐させることも設定次第で実現できるため非常に便利ですが、GASでの組み込みの場合少々複雑になりますので、ここでの説明はしません

チェックボックス

こーすけ先生

上記項目を作るには以下のようにGASを記述します

const form = FormApp.getActiveForm();
let checkboxValidation_exactly = FormApp.createCheckboxValidation()
                                        .requireSelectExactly(2)
                                        .setHelpText('2つ選択してください。')
                                        .build();

form.addCheckboxItem().setTitle('チェックボックスの質問項目')
                      .setHelpText('チェックボックスの質問項目に対する説明文')
                      .setChoiceValues(['選択肢1', '選択肢2', '選択肢3'])
                      .showOtherOption(true)
                      .setValidation(checkboxValidation_exactly)
                      .setRequired(true);

チェックボックスの場合には、選択した内容に対する検証を行うことができます
上記の場合はrequireSelectExactlyを用いたため選択することのできる個数を制限しました

こーすけ先生

その他には以下のようなものがあります

スクロールできます
メソッド名 説明
requireSelectAtLeast(number)この数以上の選択肢を選択する必要があります
requireSelectAtMost(number)選択する最大数の選択肢が必要です
requireSelectExactly(number)この数の選択肢を厳密に選択する必要があります

プルダウン

こーすけ先生

上記項目を作るには以下のようにGASを記述します

const form = FormApp.getActiveForm();
form.addListItem().setTitle('プルダウンの質問項目')
                  .setHelpText('プルダウンの質問項目に対する説明文')
                  .setChoiceValues(['選択肢1', '選択肢2', '選択肢3'])
                  .setRequired(true);

プルダウンの場合には、ラジオボタンと同様にChoice(単一の選択肢をサポート)配列によるsetChoices を用いることで選択した場合に次セクションを分岐させることも設定次第で実現できます

均等目盛

こーすけ先生

上記項目を作るには以下のようにGASを記述します

const form = FormApp.getActiveForm();
form.addScaleItem().setTitle('均等目盛の質問項目')
                   .setHelpText('均等目盛の質問項目に対する説明文')
                   .setBounds(0, 10)
                   .setLabels('最悪', '最高')
                   .setRequired(true);

選択式(グリッド)

こーすけ先生

上記項目を作るには以下のようにGASを記述します

const form = FormApp.getActiveForm();
let gridValidation = FormApp.createGridValidation()
                            .requireLimitOneResponsePerColumn()
                            .build();

form.addGridItem().setTitle('選択式(グリッド)の質問項目')
                  .setHelpText('選択式(グリッド)の質問項目に対する説明文')
                  .setRows(['1行目', '2行目', '3行目'])
                  .setColumns(['1列目', '2列目', '3列目'])
                  .setValidation(gridValidation)
                  .setRequired(true);

選択式(グリッド)の場合には、選択内容の制限を行うことができます

  • 各行1つの回答を必須にする:setRequired
  • 1列につき1つの回答に制限:setValidationrequireLimitOneResponsePerColumn

となりますのでご注意ください

チェックボックス(グリッド)

こーすけ先生

上記項目を作るには以下のようにGASを記述します

const form = FormApp.getActiveForm();
let checkboxGridValidation = FormApp.createCheckboxGridValidation()
                                    .requireLimitOneResponsePerColumn()
                                    .build();

form.addCheckboxGridItem().setTitle('チェックボックス(グリッド)の質問項目')
                          .setHelpText('チェックボックス(グリッド)の質問項目に対する説明文')
                          .setRows(['1行目', '2行目', '3行目'])
                          .setColumns(['1列目', '2列目', '3列目'])
                          .setValidation(checkboxGridValidation)
                          .setRequired(true);

チェックボックス(グリッド)の場合も選択式(グリッド)と同様の注意が必要です

日付

日付は若干の癖があります。というか、まずはDateItemDateTimeItemがありますが、これはDateTimeItemを使いましょう

これでないと、時刻を含めた日付項目を実現できません
また、GoogleのAPI仕様に明確に誤りがありますのでご留意ください

API仕様においては当該クラスに設定できるメソッドにsetIncludesYearがあります

API仕様には「日付項目に年の設定を含めるかどうかを設定します。新しい日付アイテムのデフォルトは true です」

と記載がありますが、これは明確に誤りです

こーすけ先生

その誤りを以下で確認しましょう

年も時刻も含める

こーすけ先生

上記項目を作るには以下のようにGASを記述します

const form = FormApp.getActiveForm();
form.addDateTimeItem().setTitle('日付の質問項目')
                      .setHelpText('日付の質問項目に対する説明文')
                      .setRequired(true);

年のみを含める

こーすけ先生

上記項目を作るには以下のようにGASを記述します

const form = FormApp.getActiveForm();
form.addDateTimeItem().setTitle('日付の質問項目')
                      .setHelpText('日付の質問項目に対する説明文')
                      .setIncludesYear(true)
                      .setRequired(true);

年も時刻も含めない

こーすけ先生

上記項目を作るには以下のようにGASを記述します

const form = FormApp.getActiveForm();
form.addDateTimeItem().setTitle('日付の質問項目')
                      .setHelpText('日付の質問項目に対する説明文')
                      .setIncludesYear(false)
                      .setRequired(true);

このようにsetIncludesYear呼び出すかどうかで項目の状態が変化しますので、デフォルトがtrueというわけではなく、

  • 年も時刻も含める:setIncludesYear呼び出さない
  • 年のみを含める:setIncludesYear(true)で呼び出す
  • 年も時刻も含めない:setIncludesYear(false)で呼び出す

正しい利用方法となります!

こーすけ先生

日付はけっこうややこしいのでご留意ください!

時刻

こーすけ先生

時刻も日付と同様に若干の癖があります
ですが、こちらは追加したい項目に応じて、クラスを分けるだけです

時刻に対する質問項目

こーすけ先生

上記項目を作るには以下のようにGASを記述します

const form = FormApp.getActiveForm();
form.addTimeItem().setTitle('時刻の質問項目_時刻')
                  .setHelpText('時刻の質問項目に対する説明文')
                  .setRequired(true);

経過時間に対する質問項目

こーすけ先生

上記項目を作るには以下のようにGASを記述します

const form = FormApp.getActiveForm();
form.addTimeItem().setTitle('時刻の質問項目_時刻')
                  .setHelpText('時刻の質問項目に対する説明文')
                  .setRequired(true);

レイアウト要素

タイトルと説明

こーすけ先生

上記項目を作るには以下のようにGASを記述します

const form = FormApp.getActiveForm();
form.addSectionHeaderItem().setTitle('タイトルと説明を追加')
                           .setHelpText('これは単なるレイアウト要素');

セクション

こーすけ先生

上記項目を作るには以下のようにGASを記述します

const form = FormApp.getActiveForm();
form.addPageBreakItem().setTitle('2ページ目')
                       .setHelpText('レイアウト要素ですが、分岐とかも設定が可能')

「タイトルと説明」に非常によく似ていますが、次にどのセクションへ行くか、ラジオボタンやプルダウン項目と併せてどのセクションから来るかなどを設定することができます

画像

こーすけ先生

上記項目を作るには以下のようにGASを記述します

const form = FormApp.getActiveForm();
form.addImageItem().setTitle('画像の表示項目')
                   .setHelpText('画像の表示項目に対する説明文')
                   .setImage(DriveApp.getFileById('XXXXXXXXXXXXXXXXXX').getBlob())
                   .setAlignment(FormApp.Alignment.CENTER)
                   .setWidth(300);

setImageにはBlob形式で設定する必要がありますので、例えばGoogleドライブ上の画像であれば、getFileByIdで取得したオブジェクトに対してgetBlobを用いて設定しましょう

動画

こーすけ先生

上記項目を作るには以下のようにGASを記述します

const form = FormApp.getActiveForm();
form.addVideoItem().setTitle('動画の表示項目')
                   .setHelpText('動画の表示項目に対する説明文')
                   .setVideoUrl('VyzqHFdzBKg')
                   .setAlignment(FormApp.Alignment.LEFT)
                   .setWidth(300);
こーすけ先生

setVideoUrlにはYouTube上の動画のみ許容されています。
この時、YouTube上の動画IDURLショートURLどれでも構いません

.setVideoUrl('https://www.youtube.com/watch?v=VyzqHFdzBKg')
.setVideoUrl('https://youtu.be/VyzqHFdzBKg')
こーすけ先生

こんなカンジでYouTubeを埋め込むことができるよ!

できないこと

こーすけ先生

基本的にはGUIでできることはGASから行うことができます
しかしながら、一部は実現不可な箇所がありますので、それを認識しましょう

各項目の装飾要素をいじる

Googleフォームでは、質問項目タイトルを太字にしたり、説明文の大事な箇所に下線引いたりと、装飾要素も細かに設定ができますが、これをGAS側で行うことはできません

ファイルのアップロード

Googleフォームでは「ファイルのアップロード」を質問項目として定義し、例えば申し込みに必要な添付書類を受け付けることが可能です

こーすけ先生

しかしながら、これをGAS側から追加することはできません

余談

今は、ファイルのアップロードはできませんが、いずれGASがパワーアップし、これらさえできるようになる日が来ると私は信じています

こーすけ先生

むしろ確信しています!

というのも、ファイルのアップロードに関しては、全くできないわけではありません

form.getItems().forEach(function(item){
  if (item.getTitle()=='ファイルのアップロード') {
    let uploadItem = item.duplicate();
    uploadItem.setTitle('ファイルのアップロード複製');
  }
});

とすると、item.duplicate()でエラーとなりますが、フォーム内のファイルのアップロード項目の複製されています

こーすけ先生

例えば、これが…

item.asFileUploadItem().duplicate();

とかのメソッドがGASに拡充されれば、きっと実現できるはずです!

まとめ

今回は「GASを用いたGoogleフォーム内の項目設定チートシート」ということで、Googleフォーム内の項目をGASからいじるための呼び出し方やテクニックを一括でお伝えしました

こーすけ先生

あとは、これをどう組み合わせるかです

前回の記事で行ったように回答を受け付けるのに併せてプルダウン内の項目を更新するのもいいでしょうし、各業務の実態ややりたいことに併せて取捨選択していきましょう

ぜひ、皆さんも実業務での活用に取り組んでみてください
引き続き、GASを楽しんでいきましょう!!

こーすけ先生

X(旧:Twieer)にて、ブログの更新やQiita記事の更新、GAS情報をお届けしますので、是非フォローしてください!

こーすけ先生

おかげさまで今年5月に起業しました!
GASやGoogleサービス、プログラミング全般のご相談承ります!

この記事が気に入ったら
いいね または フォローしてね!

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

GASの人。ITベンダSEとして12年勤務し、民間、金融、官公庁の現場を一通り経験済。html、css、JavaScript、Java、PHPも分かります。最近は専らGASで小規模アプリケーションを頻繁に作成しています。GASのことなら何でもお任せあれ!現在は公務員として働きながら、起業に向けて着々と準備中です!

コメント

コメントする

CAPTCHA


目次