Class MultipleChoiceItem

一种问题项，允许答题者从单选按钮列表或可选的“其他”字段中选择一个选项。可以从 Form 访问或创建项。在测验中使用时，这些题项会自动评分。

// Open a form by ID and add a new multiple choice item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addMultipleChoiceItem();
item.setTitle('Do you prefer cats or dogs?')
    .setChoices([item.createChoice('Cats'), item.createChoice('Dogs')])
    .showOtherOption(true);

方法

方法	返回类型	简介
`createChoice(value)`	`Choice`	创建新选项。
`createChoice(value, isCorrect)`	`Choice`	创建新选项。
`createChoice(value, navigationItem)`	`Choice`	创建具有页面导航选项的新选择，该选项可跳转到给定的分页符项。
`createChoice(value, navigationType)`	`Choice`	创建具有页面导航选项的新选择。
`createResponse(response)`	`ItemResponse`	为此选择题项创建新的 `ItemResponse`。
`duplicate()`	`MultipleChoiceItem`	创建相应商品的副本并将其附加到表单末尾。
`getChoices()`	`Choice[]`	获取商品的所有选项。
`getFeedbackForCorrect()`	`QuizFeedback\|null`	返回当答题者正确回答问题时向其显示的反馈。
`getFeedbackForIncorrect()`	`QuizFeedback\|null`	返回向回答者显示的反馈，当回答者对问题做出错误回答时，系统会显示此反馈。
`getHelpText()`	`String`	获取商品的帮助文本（有时称为布局项（如 `ImageItems`、`PageBreakItems` 和 `SectionHeaderItems`）的说明文本）。
`getId()`	`Integer`	获取商品的唯一标识符。
`getIndex()`	`Integer`	获取相应项在表单中所有项中的索引。
`getPoints()`	`Integer`	返回可评分项目的分值。
`getTitle()`	`String`	获取商品的标题（如果是 `SectionHeaderItem`，则有时称为标题文字）。
`getType()`	`ItemType`	获取以 `ItemType` 表示的商品类型。
`hasOtherOption()`	`Boolean`	确定相应项是否具有“其他”选项。
`isRequired()`	`Boolean`	确定答题者是否必须回答问题。
`setChoiceValues(values)`	`MultipleChoiceItem`	根据字符串数组设置商品的选项。
`setChoices(choices)`	`MultipleChoiceItem`	为项设置一个选项数组。
`setFeedbackForCorrect(feedback)`	`MultipleChoiceItem`	设置当回答者正确回答问题时向其显示的反馈。
`setFeedbackForIncorrect(feedback)`	`MultipleChoiceItem`	设置在回复者回答问题错误时向其显示的反馈。
`setHelpText(text)`	`MultipleChoiceItem`	设置商品的帮助文本（有时称为布局项的说明文本，例如 `ImageItems`、`PageBreakItems` 和 `SectionHeaderItems`）。
`setPoints(points)`	`MultipleChoiceItem`	设置可评分项目的分值。
`setRequired(enabled)`	`MultipleChoiceItem`	设置答题者是否必须回答相应问题。
`setTitle(title)`	`MultipleChoiceItem`	设置商品的标题（如果是 `SectionHeaderItem`，有时称为标题文字）。
`showOtherOption(enabled)`	`MultipleChoiceItem`	设置相应项是否具有“其他”选项。

详细文档

`createChoice(value)`

创建新选项。

参数

名称	类型	说明
`value`	`String`	选项的值，回复者在查看表单时会看到此值作为标签

Choice - 新选项

授权

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

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

`createChoice(value, isCorrect)`

创建新选项。

参数

名称	类型	说明
`value`	`String`	选项的值，回复者在查看表单时会看到此值作为标签
`isCorrect`	`Boolean`	相应选项是否为正确答案

Choice - 新选项

授权

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

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

`createChoice(value, navigationItem)`

创建具有页面导航选项的新选择，该选项可跳转到给定的分页符项。这相当于将 navigationType 设置为 FormApp.PageNavigationType.GO_TO_PAGE 的 createChoice(value, navigationType)。使用页面导航的选择项不能与不使用页面导航的选择项组合在同一项中。

只有在回复者完成包含该选项的页面并选择该选项后，系统才会进行网页导航。如果回复者在同一页面上选择了多个包含页面导航说明的选项，则只有最后一个导航选项会生效。网页导航对表单的最后一页也没有任何影响。

请注意，在商品上使用网页导航会硬编码路由，这意味着不应同时使用 showOtherOption(true)。

参数

名称	类型	说明
`value`	`String`	选项的值，回复者在查看表单时会看到此值作为标签
`navigationItem`	`PageBreakItem`	要前往的项

Choice - 新选项

授权

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

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

`createChoice(value, navigationType)`

创建具有页面导航选项的新选择。使用网页导航的选择项不能与不使用网页导航的选择项组合在同一项中。

请注意，在商品上使用网页导航会硬编码路由，这意味着不应同时使用 showOtherOption(true)。

参数

名称	类型	说明
`value`	`String`	选项的值，回复者在查看表单时会看到此值作为标签
`navigationType`	`PageNavigationType`	相应选项的导航类型

Choice - 新选项

授权

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

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

`createResponse(response)`

为此选择题项创建新的 ItemResponse。如果 response 参数与相应项的有效选项不匹配，则会抛出异常，除非 showOtherOption(enabled) 设置为 true。

参数

名称	类型	说明
`response`	`String`	相应选择题的有效答案

ItemResponse - 商品响应

授权

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

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

`duplicate()`

创建相应商品的副本并将其附加到表单末尾。

MultipleChoiceItem - 相应 MultipleChoiceItem 的副本，用于链式调用

授权

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

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

`getChoices()`

获取商品的所有选项。

Choice[] - 一组选项

授权

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

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

`getFeedbackForCorrect()`

返回当答题者正确回答问题时向其显示的反馈。

QuizFeedback|null - 反馈（如果有）。

授权

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

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

`getFeedbackForIncorrect()`

返回向回答者显示的反馈，当回答者对问题做出错误回答时，系统会显示此反馈。

QuizFeedback|null - 反馈（如果有）。

授权

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

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

获取以 ItemType 表示的商品类型。

ItemType - 商品的类型

授权

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

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

`hasOtherOption()`

确定相应项是否具有“其他”选项。

Boolean - 如果相应商品有“其他”选项；false - 如果没有true

授权

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

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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

参数

名称	类型	说明
`values`	`String[]`	选项值数组，回复者在查看表单时会看到这些值作为标签

MultipleChoiceItem - 此 MultipleChoiceItem，用于链式调用

授权

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

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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoices([item.createChoice('Cats'), item.createChoice('Dogs')]);

参数

名称	类型	说明
`choices`	`Choice[]`	一个选项数组

MultipleChoiceItem - 此 MultipleChoiceItem，用于链式调用

抛出

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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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().setText('Dogs rule, cats drool.').build(),
);

参数

名称	类型	说明
`feedback`	`QuizFeedback`	新反馈。null 值会清除反馈。

MultipleChoiceItem - 此 MultipleChoiceItem，用于链式调用

授权

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

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

`setFeedbackForIncorrect(feedback)`

设置在回复者回答问题错误时向其显示的反馈。

参数

名称	类型	说明
`feedback`	`QuizFeedback`	新反馈

MultipleChoiceItem - 此 MultipleChoiceItem，用于链式调用

授权

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

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

`setHelpText(text)`

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

参数

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

MultipleChoiceItem - 此 MultipleChoiceItem，用于链式调用

授权

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

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

`setPoints(points)`

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

参数

名称	类型	说明
`points`	`Integer`	问题项的分值

MultipleChoiceItem - 此 MultipleChoiceItem，用于链式调用

授权

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

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

`setRequired(enabled)`

设置答题者是否必须回答相应问题。

参数

名称	类型	说明
`enabled`	`Boolean`	答题者是否必须回答相应问题

MultipleChoiceItem - 当前项（用于链式调用）

授权

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

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

`setTitle(title)`

设置商品的标题（如果是 SectionHeaderItem，有时称为标题文字）。

参数

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

MultipleChoiceItem - 此 MultipleChoiceItem，用于链式调用

授权

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

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

`showOtherOption(enabled)`

设置相应项是否具有“其他”选项。新 CheckboxItem 或 MultipleChoiceItem 的默认值为 false。

参数

名称	类型	说明
`enabled`	`Boolean`	如果相应项具有“其他”选项，则为 `true`；否则为 `false`

MultipleChoiceItem - 此 MultipleChoiceItem，用于链式调用

授权

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

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

Class MultipleChoiceItem 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

方法

详细文档

createChoice(value)

参数

返回

授权

createChoice(value, isCorrect)

参数

返回

授权

createChoice(value, navigationItem)

参数

返回

授权

createChoice(value, navigationType)

参数

返回

授权

createResponse(response)

参数

返回

授权

duplicate()

返回

授权

getChoices()

返回

授权

getFeedbackForCorrect()

返回

授权

getFeedbackForIncorrect()

返回

授权

getHelpText()

返回

授权

getId()

返回

授权

getIndex()

返回

授权

getPoints()

返回

授权

getTitle()

返回

授权

getType()

返回

授权

hasOtherOption()

返回

授权

isRequired()

返回

授权

setChoiceValues(values)

参数

返回

授权

setChoices(choices)

参数

返回

抛出

授权

setFeedbackForCorrect(feedback)

参数

返回

授权

setFeedbackForIncorrect(feedback)

参数

返回

授权

setHelpText(text)

参数

返回

授权

Class MultipleChoiceItem

`createChoice(value)`

`createChoice(value, isCorrect)`

`createChoice(value, navigationItem)`

`createChoice(value, navigationType)`

`createResponse(response)`

`duplicate()`

`getChoices()`

`getFeedbackForCorrect()`

`getFeedbackForIncorrect()`

`getHelpText()`

`getId()`

`getIndex()`

`getPoints()`

`getTitle()`

`getType()`

`hasOtherOption()`

`isRequired()`

`setChoiceValues(values)`

`setChoices(choices)`

`setFeedbackForCorrect(feedback)`

`setFeedbackForIncorrect(feedback)`

`setHelpText(text)`

`setPoints(points)`

`setRequired(enabled)`

`setTitle(title)`

`showOtherOption(enabled)`