回答者が回答時間を指定できる質問項目。アイテムにアクセスできるか、
Form
から作成されています。テストで使用すると、これらのアイテムは採点されます。
// Open a form by ID and add a new duration item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addDurationItem(); item.setTitle('How long can you hold your breath?');
メソッド
メソッド | 戻り値の型 | 概要 |
---|---|---|
createResponse(hours, minutes, seconds) | ItemResponse | この日付アイテムの新しい ItemResponse を作成します。 |
duplicate() | DurationItem | このアイテムのコピーを作成してフォームの末尾に追加します。 |
getGeneralFeedback() | QuizFeedback | 採点可能な質問に回答者が回答したときに表示されるフィードバックを返します。 |
getHelpText() | String | アイテムのヘルプテキスト(ImageItems 、PageBreakItems 、SectionHeaderItems などのレイアウト アイテムの説明テキストとも呼ばれます)を取得します。 |
getId() | Integer | アイテムの一意の識別子を取得します。 |
getIndex() | Integer | フォーム内のすべてのアイテム間のアイテムのインデックスを取得します。 |
getPoints() | Integer | 採点可能なアイテムの点数を返します。 |
getTitle() | String | アイテムのタイトル(SectionHeaderItem の場合はヘッダー テキスト)を取得します。 |
getType() | ItemType | ItemType として表されるアイテムのタイプを取得します。 |
isRequired() | Boolean | 回答者が質問に回答する必要があるかどうかを判断します。 |
setGeneralFeedback(feedback) | DurationItem | 評価対象の質問に回答者が回答したときに表示されるフィードバックを設定します。 正解または不正解がない(手動による採点が必要な問題など)。 |
setHelpText(text) | DurationItem | アイテムのヘルプテキスト(ImageItems 、PageBreakItems 、SectionHeaderItems などのレイアウト アイテムの説明テキストとも呼ばれます)を設定します。 |
setPoints(points) | DurationItem | 採点可能なアイテムの評価点数を設定します。 |
setRequired(enabled) | DurationItem | 回答者が質問に回答する必要があるかどうかを設定します。 |
setTitle(title) | DurationItem | アイテムのタイトル(SectionHeaderItem の場合はヘッダー テキスト)を設定します。 |
詳細なドキュメント
createResponse(hours, minutes, seconds)
この日付アイテムの新しい ItemResponse
を作成します。引数 hours
、minutes
、seconds
は、0
~72
の整数として表すのが最適です。
59
は hours
、0
、minutes
と seconds
です。表示される値
制限されます。たとえば、24, 60, 90
は 24:59:59 と解釈されます。
パラメータ
名前 | 型 | 説明 |
---|---|---|
hours | Integer | 0 ~72 の整数で表される時間 |
minutes | Integer | 分。0 ~59 の整数で表されます。 |
seconds | Integer | 秒。0 ~59 の整数で表されます。 |
戻る
ItemResponse
- アイテム レスポンス
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
このアイテムのコピーを作成してフォームの末尾に追加します。
戻る
DurationItem
- この DurationItem
の重複(チェーン用)
承認
このメソッドを使用するスクリプトには、次のスコープの 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 | 新しいフィードバック |
戻る
DurationItem
- この DurationItem
(チェーン用)
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
アイテムのヘルプテキスト(ImageItems
、PageBreakItems
、SectionHeaderItems
などのレイアウト アイテムの説明テキストとも呼ばれます)を設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
text | String | 新しいヘルプテキスト |
戻る
DurationItem
- この DurationItem
(チェーン用)
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
採点可能なアイテムの評価点数を設定します。新しいアイテムのデフォルト値は 0 です。
パラメータ
名前 | 型 | 説明 |
---|---|---|
points | Integer | 質問アイテムが獲得するポイント数 |
戻る
DurationItem
- この DurationItem
(チェーン用)
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
回答者が質問に回答する必要があるかどうかを設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
enabled | Boolean | 回答しなければならないかどうか |
戻る
DurationItem
- 現在のアイテム(チェーン用)
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
アイテムのタイトル(SectionHeaderItem
の場合はヘッダー テキスト)を設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
title | String | 新しいタイトルまたは見出しのテキスト |
戻る
DurationItem
- この DurationItem
(チェーン用)
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms