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