一个问题项,允许回复者选择一个或多个复选框,以及可选的“其他”字段。可以通过 Form
访问或创建项。在测验中使用时,系统会自动为其评分。
// Open a form by ID and add a new checkbox item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxItem(); item.setTitle('What condiments would you like on your hot dog?') .setChoices([ item.createChoice('Ketchup'), item.createChoice('Mustard'), item.createChoice('Relish') ]) .showOtherOption(true);
方法
详细文档
clearValidation()
移除此复选框项的所有数据验证。
弃踢回攻
CheckboxItem
- 此 CheckboxItem
,用于链接
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createChoice(value)
createChoice(value, isCorrect)
createResponse(responses)
为此复选框项创建一个新的 ItemResponse
。参数 responses
是一个 String[]
数组,其中包含需要检查的值。如果任何值与此项的有效选项不匹配,则会抛出异常,除非 showOtherOption(enabled)
设置为 true
。
参数
名称 | 类型 | 说明 |
---|---|---|
responses | String[] | 此选择题的有效答案数组 |
弃踢回攻
ItemResponse
- 商品响应
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
创建此项目的副本,并将其附加到表单的末尾。
弃踢回攻
CheckboxItem
- 此 CheckboxItem
的副本,用于链接
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getChoices()
getFeedbackForCorrect()
返回在回复者正确回答问题后向其显示的反馈。
弃踢回攻
QuizFeedback
- 反馈(如果有)。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getFeedbackForIncorrect()
返回在回复者错误地回答问题时显示的反馈。
弃踢回攻
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
getPoints()
返回可评分项的分值。
弃踢回攻
Integer
- 题目的分值。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
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()
hasOtherOption()
确定相应项是否有“其他”选项。
弃踢回攻
Boolean
- 如果内容具有“other”选项,则返回 true
;如果内容具有“other”选项,则返回 false
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
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
setChoiceValues(values)
设置字符串数组中的项的选项。如果给定数组为空,则会抛出异常。
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); item.setChoiceValues(['Dogs', 'Cats']);
参数
名称 | 类型 | 说明 |
---|---|---|
values | String[] | 选项值数组,受访者在查看表单时看到的是标签 |
弃踢回攻
CheckboxItem
- 此 CheckboxItem
,用于链接
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setChoices(choices)
为项设置一组选项。如果给定数组为空或包含 null
元素,则会抛出异常。
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?') item.setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]);
参数
名称 | 类型 | 说明 |
---|---|---|
choices | Choice[] | 选项数组 |
弃踢回攻
CheckboxItem
- 此 CheckboxItem
,用于链接
抛出
Error
- 如果给定数组为 null
、为空或包含 null
元素
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForCorrect(feedback)
设置在回复者正确回答问题后向其显示的反馈。
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); // Set "Dogs" as the correct answer to this question. item.setChoices([ item.createChoice('Dogs', true), item.createChoice('Cats', false)]); // Add feedback which will be shown for correct responses; ie "Dogs". item.setFeedbackForCorrect( FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());
参数
名称 | 类型 | 说明 |
---|---|---|
feedback | QuizFeedback | 新反馈。null 值会清除反馈。 |
弃踢回攻
CheckboxItem
- 此 CheckboxItem
,用于链接
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
设置在回复者错误回答问题时向其显示的反馈。
参数
名称 | 类型 | 说明 |
---|---|---|
feedback | QuizFeedback | 获取新反馈 |
弃踢回攻
CheckboxItem
- 此 CheckboxItem
,用于链接
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
设置项的帮助文本(有时称为 ImageItems
、PageBreakItems
和 SectionHeaderItems
等布局项的说明文本)。
参数
名称 | 类型 | 说明 |
---|---|---|
text | String | 新的帮助文本 |
弃踢回攻
CheckboxItem
- 此 CheckboxItem
,用于链接
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
设置可评分项目的分值。新项的默认值为 0。
参数
名称 | 类型 | 说明 |
---|---|---|
points | Integer | 某个问题项目的分值 |
弃踢回攻
CheckboxItem
- 此 CheckboxItem
,用于链接
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
设置受访者是否必须回答问题。
参数
名称 | 类型 | 说明 |
---|---|---|
enabled | Boolean | 受访者是否必须回答问题 |
弃踢回攻
CheckboxItem
- 当前项(用于链式处理)
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
设置项目的标题(如果为 SectionHeaderItem
,则有时称为标题文本)。
参数
名称 | 类型 | 说明 |
---|---|---|
title | String | 新标题或标题文字 |
弃踢回攻
CheckboxItem
- 此 CheckboxItem
,用于链接
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
用于设置该复选框项的数据验证。如果传入 null 或验证而未调用任何需要函数,将移除任何先前的验证。
参数
名称 | 类型 | 说明 |
---|---|---|
validation | CheckboxValidation | 要应用于此项的 CheckboxValidation。 |
弃踢回攻
CheckboxItem
- 此 CheckboxItem
,用于链接
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
showOtherOption(enabled)
设置相应项是否有“其他”选项。新 CheckboxItem
或 MultipleChoiceItem
的默认值为 false
。
参数
名称 | 类型 | 说明 |
---|---|---|
enabled | Boolean | 如果菜品有“其他”选项,则为 true ;如果没有,则为 false |
弃踢回攻
CheckboxItem
- 此 CheckboxItem
,用于链接
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms