回答者がラジオボタンのリストから 1 つの選択肢を選択するか、オプションの「その他」フィールドを選択できる質問項目。アイテムは Form
からアクセスまたは作成できます。テストで使用すると、これらの項目は自動採点されます。
// Open a form by ID and add a new multiple choice item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addMultipleChoiceItem(); item.setTitle('Do you prefer cats or dogs?') .setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]) .showOtherOption(true);
Methods
詳細なドキュメント
createChoice(value)
createChoice(value, isCorrect)
createChoice(value, navigationItem)
特定の改ページアイテムにジャンプするページ ナビゲーション オプションを使用して、新しいチョイスを作成します。これは、navigationType
が FormApp.PageNavigationType.GO_TO_PAGE
に設定された createChoice(value, navigationType)
と同じです。ページ ナビゲーションを使用する選択肢と、ページ ナビゲーションを使用しない選択肢を同じアイテム内で組み合わせることはできません。
ページ ナビゲーションは、ユーザーがオプションを含むページを完了したら、そのオプションを選択した場合にのみ行われます。回答者が同じページ内でページ ナビゲーションの指示で複数の選択肢を選択した場合は、最後のナビゲーション オプションのみが有効となります。ページ ナビゲーションは、フォームの最後のページでも機能しません。
パラメータ
名前 | 型 | 説明 |
---|---|---|
value | String | 選択肢の値(フォームの表示時に回答者がラベルとして表示されます) |
navigationItem | PageBreakItem | 移動先のアイテム |
リターン
Choice
- 新しい選択肢
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(response)
この多肢選択式項目の新しい ItemResponse
を作成します。showOtherOption(enabled)
が true
に設定されている場合を除き、response
引数がこのアイテムの有効な選択肢と一致しない場合、例外をスローします。
パラメータ
名前 | 型 | 説明 |
---|---|---|
response | String | この多肢選択式項目に対する有効な回答 |
リターン
ItemResponse
- アイテムのレスポンス
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
このアイテムのコピーを作成して、フォームの末尾に追加します。
リターン
MultipleChoiceItem
- この MultipleChoiceItem
の重複(チェーン用)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getChoices()
getFeedbackForCorrect()
質問に正しく回答した回答者に表示されるフィードバックを返します。
リターン
QuizFeedback
- フィードバック(ある場合)。
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getFeedbackForIncorrect()
質問に正しく回答しなかったときに回答者に表示されるフィードバックを返します。
リターン
QuizFeedback
- フィードバック(ある場合)。
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
アイテムのヘルプテキスト(ImageItems
、PageBreakItems
、SectionHeaderItems
などのレイアウト アイテムの説明テキスト)を取得します。
リターン
String
- アイテムのヘルプテキストまたは説明テキスト
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
アイテムの一意の識別子を取得します。
リターン
Integer
- 商品アイテムの ID
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
フォーム内のすべてのアイテムの中でアイテムのインデックスを取得します。
リターン
Integer
- アイテムのインデックス
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getPoints()
採点可能なアイテムの点数を返します。
リターン
Integer
- 質問によって付与される点数。
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
アイテムのタイトル(SectionHeaderItem
の場合にヘッダー テキストとも呼ばれます)を取得します。
リターン
String
- アイテムのタイトルまたはヘッダー テキスト
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
hasOtherOption()
アイテムに「その他」オプションがあるかどうかを指定します。
リターン
Boolean
- 商品アイテムに「その他」のオプションがある場合は true
、そうでない場合は false
。
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isRequired()
回答者が質問に回答する必要があるかどうかを判断します。
リターン
Boolean
- 回答者が質問に回答する必要があるかどうか
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setChoiceValues(values)
文字列の配列からアイテムの選択を設定します。指定された配列が空の場合に例外をスローします。
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); item.setChoiceValues(['Dogs', 'Cats']);
パラメータ
名前 | 型 | 説明 |
---|---|---|
values | String[] | 選択肢の値の配列(フォームの閲覧時に回答者がラベルとして表示されます) |
リターン
MultipleChoiceItem
- この MultipleChoiceItem
(チェーン用)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setChoices(choices)
商品アイテムの選択肢の配列を設定します。指定された配列が空の場合、または null
要素を含む場合に例外をスローします。
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?') item.setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]);
パラメータ
名前 | 型 | 説明 |
---|---|---|
choices | Choice[] | 選択肢の配列 |
リターン
MultipleChoiceItem
- この MultipleChoiceItem
(チェーン用)
例外
Error
- 指定された配列が null
の場合、空の場合、または null
要素が含まれている場合
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForCorrect(feedback)
質問に正しく回答した回答者に表示されるフィードバックを設定します。
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); // Set "Dogs" as the correct answer to this question. item.setChoices([ item.createChoice('Dogs', true), item.createChoice('Cats', false)]); // Add feedback which will be shown for correct responses; ie "Dogs". item.setFeedbackForCorrect( FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());
パラメータ
名前 | 型 | 説明 |
---|---|---|
feedback | QuizFeedback | 確認します。null 値を指定するとフィードバックが消去されます。 |
リターン
MultipleChoiceItem
- この MultipleChoiceItem
(チェーン用)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
質問に正しく回答していない回答者に表示されるフィードバックを設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
feedback | QuizFeedback | 新しいフィードバックは |
リターン
MultipleChoiceItem
- この MultipleChoiceItem
(チェーン用)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
アイテムのヘルプテキスト(ImageItems
、PageBreakItems
、SectionHeaderItems
などのレイアウト アイテムの説明テキスト)を設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
text | String | 新しいヘルプテキスト |
リターン
MultipleChoiceItem
- この MultipleChoiceItem
(チェーン用)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
採点対象のアイテムが持つ点数を設定します。新しいアイテムのデフォルトは 0 です。
パラメータ
名前 | 型 | 説明 |
---|---|---|
points | Integer | 質問アイテムが持つポイント数 |
リターン
MultipleChoiceItem
- この MultipleChoiceItem
(チェーン用)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
回答者が質問に回答する必要があるかどうかを設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
enabled | Boolean | 回答者が質問に答える必要があるかどうか |
リターン
MultipleChoiceItem
- 現在のアイテム(チェーンの場合)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
アイテムのタイトル(SectionHeaderItem
ではヘッダー テキストとも呼ばれます)を設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
title | String | 新しいタイトルまたはヘッダー テキスト |
リターン
MultipleChoiceItem
- この MultipleChoiceItem
(チェーン用)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
showOtherOption(enabled)
アイテムに「その他」オプションがあるかどうかを設定します。新しい CheckboxItem
または MultipleChoiceItem
のデフォルトは false
です。
パラメータ
名前 | 型 | 説明 |
---|---|---|
enabled | Boolean | 商品アイテムに「その他」のオプションがある場合は true 、そうでない場合は false 。 |
リターン
MultipleChoiceItem
- この MultipleChoiceItem
(チェーン用)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms