回答者がテキスト ブロックを入力できる質問項目。アイテムには Form からアクセスしたり、Form から作成したりできます。テストで使用される場合、これらのアイテムは採点されます。
// Open a form by ID and add a new paragraph text item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addParagraphTextItem(); item.setTitle('What is your address?');
メソッド
| メソッド | 戻り値の型 | 概要 |
|---|---|---|
clear | Paragraph | この段落テキスト項目のデータ入力規則を削除します。 |
create | Item | この段落テキスト アイテムの新しい Item を作成します。 |
duplicate() | Paragraph | この項目のコピーを作成し、フォームの末尾に追加します。 |
get | Quiz | 採点可能な質問に回答したときに回答者に表示されるフィードバックを返します。 |
get | String | アイテムのヘルプ テキストを取得します(Image、Page、Section などのレイアウト アイテムの説明テキストと呼ばれることもあります)。 |
get | Integer | アイテムの固有識別子を取得します。 |
get | Integer | フォーム内のすべてのアイテムの中で、アイテムのインデックスを取得します。 |
get | Integer | 採点可能なアイテムの点数を返します。 |
get | String | アイテムのタイトルを取得します(Section の場合はヘッダー テキストと呼ばれることもあります)。 |
get | Item | Item として表されるアイテムのタイプを取得します。 |
is | Boolean | 回答者が質問に回答する必要があるかどうかを決定します。 |
set | Paragraph | 正解または不正解のない採点可能な質問(手動採点が必要な質問など)に回答者が回答したときに表示されるフィードバックを設定します。 |
set | Paragraph | アイテムのヘルプ テキスト(Image、Page、Section などのレイアウト アイテムの説明テキストとも呼ばれます)を設定します。 |
set | Paragraph | 採点可能なアイテムの点数を設定します。 |
set | Paragraph | 回答者が質問に回答する必要があるかどうかを設定します。 |
set | Paragraph | アイテムのタイトルを設定します(Section の場合はヘッダー テキストと呼ばれることもあります)。 |
set | Paragraph | この段落テキスト項目のデータの入力規則を設定します。 |
詳細なドキュメント
clearValidation()
この段落テキスト項目のデータ入力規則を削除します。
戻る
ParagraphTextItem - チェーン用の ParagraphTextItem
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
createResponse(response)
この段落テキスト アイテムの新しい ItemResponse を作成します。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
response | String | アイテムによって提示された質問に対する回答 |
戻る
ItemResponse - アイテムのレスポンス
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
duplicate()
この項目のコピーを作成し、フォームの末尾に追加します。
戻る
ParagraphTextItem - チェーン用のこの ParagraphTextItem の複製
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getGeneralFeedback()
採点可能な質問に回答したときに回答者に表示されるフィードバックを返します。
戻る
QuizFeedback|null - フィードバック(ある場合)。
承認
このメソッドを使用するスクリプトには、次の 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()
isRequired()
回答者が質問に回答する必要があるかどうかを決定します。
戻る
Boolean - 回答者が質問に回答する必要があるかどうか
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
正解または不正解のない採点可能な質問(手動採点が必要な質問など)に回答者が回答したときに表示されるフィードバックを設定します。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
feedback | Quiz | 新しいフィードバック |
戻る
ParagraphTextItem - チェーン用の ParagraphTextItem
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setHelpText(text)
アイテムのヘルプテキスト(ImageItems、PageBreakItems、SectionHeaderItems などのレイアウト アイテムの説明テキストとも呼ばれます)を設定します。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
text | String | 新しいヘルプテキスト |
戻る
ParagraphTextItem - チェーン用の ParagraphTextItem
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setPoints(points)
採点可能なアイテムの点数を設定します。新しいアイテムのデフォルトは 0 です。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
points | Integer | 質問項目の点数 |
戻る
ParagraphTextItem - チェーン用の ParagraphTextItem
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setRequired(enabled)
回答者が質問に回答する必要があるかどうかを設定します。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
enabled | Boolean | 回答者が質問に回答する必要があるかどうか |
戻る
ParagraphTextItem - 現在のアイテム(チェーン用)
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setTitle(title)
アイテムのタイトルを設定します(SectionHeaderItem の場合はヘッダー テキストと呼ばれることもあります)。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
title | String | 新しいタイトルまたはヘッダー テキスト |
戻る
ParagraphTextItem - チェーン用の ParagraphTextItem
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setValidation(validation)
この段落テキスト項目のデータの入力規則を設定します。null または require 関数が呼び出されていない ParagraphTextValidation インスタンスを渡すと、以前の検証がすべて削除されます。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
validation | Paragraph | このアイテムに適用する ParagraphTextValidation。 |
戻る
ParagraphTextItem - チェーン用の ParagraphTextItem
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms