一連のラジオボタンから 1 つのオプションを回答者が選択できる質問項目。アイテムは Form
からアクセスまたは作成できます。テストで使用すると、
項目が採点されます
// Open a form by ID and add a new scale item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addScaleItem(); item.setTitle('Pick a number between 1 and 10') .setBounds(1, 10);
Methods
メソッド | 戻り値の型 | 概要 |
---|---|---|
createResponse(response) | ItemResponse | この体重計アイテム用に新しい ItemResponse を作成します。 |
duplicate() | ScaleItem | このアイテムのコピーを作成して、フォームの末尾に追加します。 |
getGeneralFeedback() | QuizFeedback | 採点可能な質問に回答したときに回答者に表示されるフィードバックを返します。 |
getHelpText() | String | アイテムのヘルプテキスト(ImageItems 、PageBreakItems 、SectionHeaderItems などのレイアウト アイテムの説明テキスト)を取得します。 |
getId() | Integer | アイテムの一意の識別子を取得します。 |
getIndex() | Integer | フォーム内のすべてのアイテムの中でアイテムのインデックスを取得します。 |
getLeftLabel() | String | スケールの下限のラベルを取得します(存在する場合)。 |
getLowerBound() | Integer | スケールの下限を取得します。 |
getPoints() | Integer | 採点可能なアイテムの点数を返します。 |
getRightLabel() | String | スケールの上限のラベルを取得します(存在する場合)。 |
getTitle() | String | アイテムのタイトル(SectionHeaderItem の場合にヘッダー テキストとも呼ばれます)を取得します。 |
getType() | ItemType | ItemType で表されるアイテムのタイプを取得します。 |
getUpperBound() | Integer | スケールの上限を取得します。 |
isRequired() | Boolean | 回答者が質問に回答する必要があるかどうかを判断します。 |
setBounds(lower, upper) | ScaleItem | スケールの下限と上限を設定します。 |
setGeneralFeedback(feedback) | ScaleItem | 正解または不正解のない採点可能な質問(手動採点が必要な質問など)に回答者が回答したときに表示されるフィードバックを設定します。 |
setHelpText(text) | ScaleItem | アイテムのヘルプテキスト(ImageItems 、PageBreakItems 、SectionHeaderItems などのレイアウト アイテムの説明テキスト)を設定します。 |
setLabels(lower, upper) | ScaleItem | スケールの下限と上限のラベルを設定します。 |
setPoints(points) | ScaleItem | 採点対象のアイテムが持つ点数を設定します。 |
setRequired(enabled) | ScaleItem | 回答者が質問に回答する必要があるかどうかを設定します。 |
setTitle(title) | ScaleItem | アイテムのタイトル(SectionHeaderItem ではヘッダー テキストとも呼ばれます)を設定します。 |
詳細なドキュメント
createResponse(response)
この体重計アイテム用に新しい ItemResponse
を作成します。response
引数がアイテムに設定された境界外にある場合、例外をスローします。
パラメータ
名前 | 型 | 説明 |
---|---|---|
response | Integer | このスケール項目の値の回答 |
リターン
ItemResponse
- アイテムのレスポンス
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
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
getLeftLabel()
スケールの下限のラベルを取得します(存在する場合)。
リターン
String
- スケールの下限のラベル
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getLowerBound()
スケールの下限を取得します。
リターン
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
getRightLabel()
スケールの上限のラベルを取得します(存在する場合)。
リターン
String
- スケールの上限のラベル
承認
この方法を使用するスクリプトには、次の 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()
getUpperBound()
スケールの上限を取得します。
リターン
Integer
- スケールの上限
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isRequired()
回答者が質問に回答する必要があるかどうかを判断します。
リターン
Boolean
- 回答者が質問に回答する必要があるかどうか
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setBounds(lower, upper)
スケールの下限と上限を設定します。下限は 0
または 1
にする必要があります。上限は 3
~10
の範囲で指定する必要があります。新しいスケールのデフォルト値は、下限 1
、上限 5
です。
指定された値が許容範囲外の場合に、スクリプト例外をスローします。小数は前の整数に切り捨てられます。
パラメータ
名前 | 型 | 説明 |
---|---|---|
lower | Integer | 新しい下限は |
upper | Integer | 新しい上限は |
リターン
ScaleItem
- この ScaleItem
(チェーン用)
例外
Error
- 下限または上限が無効な場合
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
正解または不正解のない採点可能な質問(手動採点が必要な質問など)に回答者が回答したときに表示されるフィードバックを設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
feedback | QuizFeedback | 新しいフィードバックは |
リターン
ScaleItem
- この ScaleItem
(チェーン用)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
アイテムのヘルプテキスト(ImageItems
、PageBreakItems
、SectionHeaderItems
などのレイアウト アイテムの説明テキスト)を設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
text | String | 新しいヘルプテキスト |
リターン
ScaleItem
- この ScaleItem
(チェーン用)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setLabels(lower, upper)
setPoints(points)
setRequired(enabled)
setTitle(title)
アイテムのタイトル(SectionHeaderItem
ではヘッダー テキストとも呼ばれます)を設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
title | String | 新しいタイトルまたはヘッダー テキスト |
リターン
ScaleItem
- この ScaleItem
(チェーン用)
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms