回答者が期間を指定できる質問項目。アイテムには 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 の場合はヘッダー テキスト)を設定します。 |
詳細なドキュメント
create Response(hours, minutes, seconds)
この日付アイテムの新しい Item
を作成します。引数 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 の整数) |
戻る
Item
- アイテムの回答
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
この項目のコピーを作成して、フォームの末尾に追加します。
戻る
Duration
- チェーン用にこの Duration
の複製
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get General Feedback()
回答者が採点対象の質問に回答したときに表示されるフィードバックを返します。
戻る
Quiz
- フィードバック(ある場合)。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Help Text()
アイテムのヘルプテキストを取得します(Image
、Page
、Section
などのレイアウト アイテムの説明テキストとも呼ばれます)。
戻る
String
- アイテムのヘルプテキストまたは説明文
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Id()
アイテムの一意の識別子を取得します。
戻る
Integer
- アイテムの ID
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Index()
フォーム内のすべてのアイテムの中で、アイテムのインデックスを取得します。
戻る
Integer
- アイテムのインデックス
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Points()
採点対象の項目のポイント値を返します。
戻る
Integer
- 質問の点数。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Title()
アイテムのタイトルを取得します(Section
の場合はヘッダー テキストと呼ばれることもあります)。
戻る
String
- アイテムのタイトルまたはヘッダー テキスト
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Type()
is Required()
回答者が質問に回答する必要があるかどうかを判断します。
戻る
Boolean
- 回答者が質問に回答する必要があるかどうか
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set General Feedback(feedback)
正解や不正解がない採点対象の質問(手動採点が必要な質問)に回答したときに、回答者に表示されるフィードバックを設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
feedback | Quiz | 新しいフィードバック |
戻る
Duration
- チェーン用の this Duration
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Help Text(text)
アイテムのヘルプテキスト(Image
、Page
、Section
などのレイアウト アイテムの説明テキスト)を設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
text | String | 新しいヘルプテキスト |
戻る
Duration
- チェーン用の this Duration
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Points(points)
採点対象の項目に割り当てるポイント数を設定します。新規アイテムのデフォルトは 0 です。
パラメータ
名前 | 型 | 説明 |
---|---|---|
points | Integer | 問題アイテムの点数 |
戻る
Duration
- チェーン用の this Duration
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Required(enabled)
回答者が質問に回答する必要があるかどうかを設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
enabled | Boolean | 回答者が質問に回答する必要があるかどうか |
戻る
Duration
- 現在のアイテム(チェーン用)
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Title(title)
アイテムのタイトル(Section
の場合はヘッダー テキスト)を設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
title | String | 新しいタイトルまたはヘッダー テキスト |
戻る
Duration
- チェーン用の this Duration
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms