回答者が期間を指定できる質問アイテム。アイテムには Form からアクセスまたは作成できます。クイズで使用する場合、これらのアイテムは採点されます。
// Open a form by ID and add a new duration item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addDurationItem(); item.setTitle('How long can you hold your breath?');
メソッド
| メソッド | 戻り値の型 | 概要 |
|---|---|---|
create | Item | この日付アイテムの新しい Item を作成します。 |
duplicate() | Duration | このアイテムのコピーを作成し、フォームの末尾に追加します。 |
get | Quiz | 採点可能な質問に回答したときに回答者に表示されるフィードバックを返します。 |
get | String | アイテムのヘルプテキストを取得します(Image、Page、Section などのレイアウト アイテムの説明テキストと呼ばれることもあります)。 |
get | Integer | アイテムの一意の識別子を取得します。 |
get | Integer | フォーム内のすべてのアイテムの中で、アイテムのインデックスを取得します。 |
get | Integer | 採点可能なアイテムの点数を返します。 |
get | String | アイテムのタイトルを取得します(Section の場合はヘッダー テキストと呼ばれることもあります)。 |
get | Item | アイテムのタイプを Item として取得します。 |
is | Boolean | 回答者が質問に回答する必要があるかどうかを判断します。 |
set | Duration | 正解または不正解の回答がない採点可能な質問(手動採点が必要な質問)に回答したときに回答者に表示されるフィードバックを設定します。 |
set | Duration | アイテムのヘルプテキストを設定します(Image、Page、Section などのレイアウト アイテムの説明テキストと呼ばれることもあります)。 |
set | Duration | 採点可能なアイテムの点数を設定します。 |
set | Duration | 回答者が質問に回答する必要があるかどうかを設定します。 |
set | Duration | アイテムのタイトルを設定します(Section の場合はヘッダー テキストと呼ばれることもあります)。 |
詳細なドキュメント
createResponse(hours, minutes, seconds)
この日付アイテムの新しい ItemResponse を作成します。引数 hours、minutes、seconds は、hours の場合は 0~72 の整数、minutes と seconds の場合は 0~59 の整数で表すことをおすすめします。これらの範囲を超える値はクランプされます。たとえば、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|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 | 新しいフィードバック |
戻る
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