Class ScaleItem

缩放项

一种题目项，可让回复者从编号的单选按钮序列中选择一个选项。您可以通过 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);

方法

方法	返回类型	简介
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 - 内容响应

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

duplicate()

创建此项的副本，并将其附加到表单的末尾。

返回

ScaleItem - 此 ScaleItem 的副本，用于链式调用

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getGeneralFeedback()

返回在回复可评分题目时向回答者显示的反馈。

返回

QuizFeedback - 反馈（如果有）。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getHelpText()

获取项的帮助文本（对于 ImageItems、PageBreakItems 和 SectionHeaderItems 等布局项，有时也称为说明文本）。

返回

String - 商品的帮助文本或说明文字

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getId()

获取内容的唯一标识符。

返回

Integer - 商品的 ID

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getIndex()

获取表单中所有项中的项的索引。

返回

Integer - 项的索引

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getLeftLabel()

获取比例下限的标签（如果有）。

返回

String - 刻度下限的标签

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getLowerBound()

获取刻度的下限。

返回

Integer - 刻度的下限

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getPoints()

返回可评分的项的分值。

返回

Integer - 题目的分值。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getRightLabel()

获取比例上限的标签（如果有）。

返回

String - 刻度上限的标签

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getTitle()

获取项的标题（对于 SectionHeaderItem，有时称为标题文本）。

返回

String - 商品的标题或标题文本

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getType()

获取项的类型，表示为 ItemType。

返回

ItemType - 内容的类型

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getUpperBound()

获取刻度的上限。

返回

Integer - 刻度的上限

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

isRequired()

确定回复者是否必须回答该问题。

返回

Boolean - 回复者是否必须回答此问题

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• 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 - 如果下限或上限无效

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

setGeneralFeedback(feedback)

设置在回复者回答没有正确或错误答案的可评分问题（即需要手动评分的题目）时向其显示的反馈。

参数

名称	类型	说明
feedback	QuizFeedback	新反馈

返回

ScaleItem - 此 ScaleItem，用于链式调用

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

setHelpText(text)

设置项的帮助文本（对于布局项，有时也称为说明文本，例如 ImageItems、PageBreakItems 和 SectionHeaderItems）。

参数

名称	类型	说明
text	String	新的帮助文本

返回

ScaleItem - 此 ScaleItem，用于链式调用

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

setLabels(lower, upper)

为刻度的下限和上限设置标签。

参数

名称	类型	说明
lower	String	下限的新标签
upper	String	上限的新标签

返回

ScaleItem - 此 ScaleItem，用于链式调用

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

setPoints(points)

设置可评分的项目的分值。新商品的默认值为 0。

参数

名称	类型	说明
points	Integer	题目项对应的分数

返回

ScaleItem - 此 ScaleItem，用于链式调用

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

setRequired(enabled)

设置回复者是否必须回答该问题。

参数

名称	类型	说明
enabled	Boolean	受访者是否必须回答此问题

返回

ScaleItem - 当前项（用于链接）

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

setTitle(title)

设置项的标题（对于 SectionHeaderItem，有时称为标题文本）。

参数

名称	类型	说明
title	String	新标题或标题文字

返回

ScaleItem - 此 ScaleItem，用于链式调用

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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