Class ScaleItem

ScaleItem

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

方法

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