回答者が時刻を指定できる質問アイテム。アイテムには Form
からアクセスまたは作成できます。クイズで使用すると、これらの項目は採点されます。
// Open a form by ID and add a new time item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addTimeItem(); item.setTitle('What time do you usually wake up in the morning?');
メソッド
メソッド | 戻り値の型 | 概要 |
---|---|---|
create | Item | この時間アイテムの新しい Item を作成します。 |
duplicate() | Time | この項目のコピーを作成して、フォームの末尾に追加します。 |
get | Quiz | 回答者が採点対象の質問に回答したときに表示されるフィードバックを返します。 |
get | String | アイテムのヘルプテキストを取得します(Image 、Page 、Section などのレイアウト アイテムの説明テキストとも呼ばれます)。 |
get | Integer | アイテムの一意の識別子を取得します。 |
get | Integer | フォーム内のすべてのアイテムの中で、アイテムのインデックスを取得します。 |
get | Integer | 採点対象の項目のポイント値を返します。 |
get | String | アイテムのタイトルを取得します(Section の場合はヘッダー テキストと呼ばれることもあります)。 |
get | Item | アイテムのタイプ(Item として表されます)を取得します。 |
is | Boolean | 回答者が質問に回答する必要があるかどうかを判断します。 |
set | Time | 正解や不正解がない採点対象の質問(手動採点が必要な質問)に回答したときに、回答者に表示されるフィードバックを設定します。 |
set | Time | アイテムのヘルプテキスト(Image 、Page 、Section などのレイアウト アイテムの説明テキスト)を設定します。 |
set | Time | 採点対象の項目に割り当てるポイント数を設定します。 |
set | Time | 回答者が質問に回答する必要があるかどうかを設定します。 |
set | Time | アイテムのタイトル(Section の場合はヘッダー テキスト)を設定します。 |
詳細なドキュメント
create Response(hour, minute)
この時間アイテムの新しい Item
を作成します。引数 hour
と minute
は、それぞれ 0
~23
と 0
~59
の整数として表すのが適切です。これらの上限を超えると、時計のように動作します。たとえば、10, 90
は 11:30 と解釈され、-1, 60
は 00:00 と解釈されます。
パラメータ
名前 | 型 | 説明 |
---|---|---|
hour | Integer | 時間(0 ~23 の整数で表されます) |
minute | Integer | 分(0 ~59 の整数で表されます)。 |
戻る
Item
- アイテムの回答
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
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 | 新しいフィードバック |
戻る
Time
- チェーン用の this Time
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Help Text(text)
アイテムのヘルプテキスト(Image
、Page
、Section
などのレイアウト アイテムの説明テキスト)を設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
text | String | 新しいヘルプテキスト |
戻る
Time
- チェーン用の this Time
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Points(points)
set Required(enabled)
set Title(title)
アイテムのタイトル(Section
の場合はヘッダー テキスト)を設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
title | String | 新しいタイトルまたはヘッダー テキスト |
戻る
Time
- チェーン用の this Time
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms