回答者が番号付きのラジオボタンのシーケンスから 1 つのオプションを選択できる質問項目。アイテムには Form からアクセスしたり、作成したりできます。テストで使用される場合、これらの項目は採点されます。
// Open a form by ID and add a new scale item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addScaleItem(); item.setTitle('Pick a number between 1 and 10').setBounds(1, 10);
メソッド
| メソッド | 戻り値の型 | 概要 |
|---|---|---|
create | Item | このスケール アイテムの新しい Item を作成します。 |
duplicate() | Scale | この項目のコピーを作成し、フォームの末尾に追加します。 |
get | Quiz | 採点可能な質問に回答したときに回答者に表示されるフィードバックを返します。 |
get | String | アイテムのヘルプ テキスト(Image、Page、Section などのレイアウト アイテムの説明テキストとも呼ばれます)を取得します。 |
get | Integer | アイテムの固有識別子を取得します。 |
get | Integer | フォーム内のすべてのアイテムの中で、アイテムのインデックスを取得します。 |
get | String | スケールの下限のラベルを取得します(存在する場合)。 |
get | Integer | スケールの下限を取得します。 |
get | Integer | 採点可能なアイテムの点数を返します。 |
get | String | スケールの上限のラベルを取得します(存在する場合)。 |
get | String | アイテムのタイトルを取得します(Section の場合はヘッダー テキストと呼ばれることもあります)。 |
get | Item | Item として表されるアイテムのタイプを取得します。 |
get | Integer | スケールの上限を取得します。 |
is | Boolean | 回答者が質問に回答する必要があるかどうかを決定します。 |
set | Scale | スケールの下限と上限を設定します。 |
set | Scale | 正解または不正解のない採点可能な質問(手動採点が必要な質問など)に回答者が回答したときに表示されるフィードバックを設定します。 |
set | Scale | アイテムのヘルプテキスト(Image、Page、Section などのレイアウト アイテムの説明テキストとも呼ばれます)を設定します。 |
set | Scale | スケールの下限と上限のラベルを設定します。 |
set | Scale | 採点可能なアイテムの点数を設定します。 |
set | Scale | 回答者が質問に回答する必要があるかどうかを設定します。 |
set | Scale | アイテムのタイトルを設定します(Section の場合はヘッダー テキストと呼ばれることもあります)。 |
詳細なドキュメント
create Response(response)
このスケール アイテムの新しい Item を作成します。response 引数がアイテムに設定された境界外にある場合、例外をスローします。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
response | Integer | このスケール項目の値の回答 |
戻る
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 Left Label()
スケールの下限のラベルを取得します(存在する場合)。
戻る
String - スケールの下限のラベル
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Lower Bound()
スケールの下限を取得します。
戻る
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 Right Label()
スケールの上限のラベルを取得します(存在する場合)。
戻る
String - スケールの上限のラベル
承認
このメソッドを使用するスクリプトには、次の 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()
get Upper Bound()
スケールの上限を取得します。
戻る
Integer - スケールの上限
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
is Required()
回答者が質問に回答する必要があるかどうかを決定します。
戻る
Boolean - 回答者が質問に回答する必要があるかどうか
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Bounds(lower, upper)
スケールの下限と上限を設定します。下限は 0 または 1 にする必要があります。上限は 3~10 の範囲で指定してください(最小値と最大値を範囲に含む)。新しいスケールのデフォルトの下限は 1、上限は 5 です。
指定された値が許容範囲外の場合、スクリプト例外をスローします。小数部分は切り捨てられ、前の整数になります。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
lower | Integer | 新しい下限 |
upper | Integer | 新しい上限 |
戻る
例外
Error - 下限または上限が無効な場合
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set General Feedback(feedback)
正解または不正解のない採点可能な質問(手動採点が必要な質問など)に回答者が回答したときに表示されるフィードバックを設定します。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
feedback | Quiz | 新しいフィードバック |
戻る
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Help Text(text)
アイテムのヘルプテキスト(Image、Page、Section などのレイアウト アイテムの説明テキストとも呼ばれます)を設定します。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
text | String | 新しいヘルプテキスト |
戻る
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Labels(lower, upper)
set Points(points)
set Required(enabled)
set Title(title)
アイテムのタイトルを設定します(Section の場合はヘッダー テキストと呼ばれることもあります)。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
title | String | 新しいタイトルまたはヘッダー テキスト |
戻る
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms