Class ScaleItem

ScaleItem

番号が付いた一連のラジオボタンから回答者が 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()ItemTypeItemType として表されるアイテムのタイプを取得します。
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 引数がアイテムに設定された境界外である場合、例外をスローします。

パラメータ

名前型説明
responseIntegerこのスケール項目の価値回答

戻る

ItemResponse - アイテムのレスポンス

認可

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

duplicate()

このアイテムのコピーを作成し、フォームの末尾に追加します。

戻る

ScaleItem - この ScaleItem の重複（チェーンの場合）

認可

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

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()

ItemType として表されるアイテムのタイプを取得します。

戻る

ItemType - 商品アイテムのタイプ

認可

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

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 の上限に設定されます。

指定された値が上限を超えている場合は、スクリプトの例外をスローします。小数点以下の桁数は切り捨てられます。

パラメータ

名前型説明
lowerInteger新しい下限
upperInteger新しい上限

戻る

ScaleItem - この ScaleItem（チェーンの場合）

スロー値

Error - 下限または上限が無効な場合

認可

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setGeneralFeedback(feedback)

正解または不正解の採点可能な質問（手動採点を必要とする質問など）に回答するときに、回答者に表示されるフィードバックを設定します。

パラメータ

名前型説明
feedbackQuizFeedback新しいフィードバック

戻る

ScaleItem - この ScaleItem（チェーンの場合）

認可

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setHelpText(text)

アイテムのヘルプテキスト（ImageItems、PageBreakItems、SectionHeaderItems などのレイアウト アイテムの説明テキストとも呼ばれます）を設定します。

パラメータ

名前型説明
textString新しいヘルプテキスト

戻る

ScaleItem - この ScaleItem（チェーンの場合）

認可

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setLabels(lower, upper)

スケールの下限と上限のラベルを設定します。

パラメータ

名前型説明
lowerString下限の新しいラベル
upperString上限の新しいラベル

戻る

ScaleItem - この ScaleItem（チェーンの場合）

認可

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setPoints(points)

採点可能なアイテムの点数を設定します。新しい商品アイテムのデフォルトは 0 です。

パラメータ

名前型説明
pointsInteger質問項目に割り当てる点数

戻る

ScaleItem - この ScaleItem（チェーンの場合）

認可

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setRequired(enabled)

回答者が質問に答える必要があるかどうかを設定します。

パラメータ

名前型説明
enabledBoolean回答者が質問に答える必要があるかどうか

戻る

ScaleItem - 現在の項目（チェーンの場合）

認可

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setTitle(title)

アイテムのタイトルを設定します（SectionHeaderItem の場合はヘッダー テキストとも呼ばれます）。

パラメータ

名前型説明
titleString新しいタイトルまたはヘッダー テキスト

戻る

ScaleItem - この ScaleItem（チェーンの場合）

認可

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms