对表单中的一个问题项的响应。您可以通过 FormResponse
访问商品回复,也可以通过任何会要求回复者回答问题的 Item
来创建商品回复。
// Open a form by ID and log the responses to each question. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var formResponses = form.getResponses(); for (var i = 0; i < formResponses.length; i++) { var formResponse = formResponses[i]; var itemResponses = formResponse.getItemResponses(); for (var j = 0; j < itemResponses.length; j++) { var itemResponse = itemResponses[j]; Logger.log('Response #%s to the question "%s" was "%s"', (i + 1).toString(), itemResponse.getItem().getTitle(), itemResponse.getResponse()); } }
方法
方法 | 返回类型 | 简介 |
---|---|---|
getFeedback() | Object | 获取为回复者提交的回答提供的反馈。 |
getItem() | Item | 获取此回答所回答的问题。 |
getResponse() | Object | 获取受访者提交的答案。 |
getScore() | Object | 获取受访者提交的答案的得分。 |
setFeedback(feedback) | ItemResponse | 设置应针对受访者提交的答案显示的反馈。 |
setScore(score) | ItemResponse | 设置受访者提交的答案的得分。 |
详细文档
getFeedback()
获取为回复者提交的回答提供的反馈。
返回
Object
- 问题项的 QuizFeedback
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getItem()
getResponse()
获取受访者提交的答案。对于大多数类型的题目,此方法会返回 String
。
对于 CheckboxItem
问题,这将返回一个 String[]
数组,其中包含回复者的选择。数组中字符串的顺序可能会有所不同。
对于 GridItem
问题,这将返回一个 String[]
数组,其中索引 n
处的答案与网格中第 n + 1
行的问题相对应。如果受访者未在网格中回答问题,则答案会以 ''
的形式返回。
对于 CheckboxGridItem
问题,这将返回一个 String[][]
数组,其中行索引 n
中的答案对应于复选框网格中第 n + 1
行的问题。如果受访者未在网格中回答问题,系统会以 ''
的形式返回答案。
返回
Object
- 问题项的 String
、String[]
或 String[][]
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getScore()
获取受访者提交的答案的得分。
返回
Object
- 表示问题项得分的 Double
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedback(feedback)
设置应针对受访者提交的答案显示的反馈。
在使用更新的 FormResponses 调用 Form.submitGrades(responses)
之前,此方法实际上并不会将反馈保存在表单中。有关示例,请参阅 setScore()
。
参数
名称 | 类型 | 说明 |
---|---|---|
feedback | Object |
返回
ItemResponse
- 用于链接的 ItemResponse
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setScore(score)
设置受访者提交的答案的得分。null 值将清除现有得分。
在使用更新后的 FormResponses 调用 Form.submitGrades(responses)
之前,此方法实际上不会在 Google 表单中保存得分。
// For a multiple choice question with options: "Always true", "Sometimes true", and "Never", // award half credit for responses that answered "Sometimes true". var formResponses = FormApp.getActiveForm().getResponses(); // Go through each form response for (var i = 0; i < formResponses.length; i++) { var response = formResponses[i]; var items = FormApp.getActiveForm().getItems(); // Assume it's the first item var item = items[0]; var itemResponse = response.getGradableResponseForItem(item); // Give half credit for "Sometimes true". if (itemResponse != null && itemResponse.getResponse() == 'Sometimes true') { var points = item.asMultipleChoiceItem().getPoints(); itemResponse.setScore(points * .5); // This saves the grade, but does not submit to Forms yet. response.withItemGrade(itemResponse); } } // Grades are actually submitted to Forms here. FormApp.getActiveForm().submitGrades(formResponses);
参数
名称 | 类型 | 说明 |
---|---|---|
score | Object |
返回
ItemResponse
- 用于链接的 ItemResponse
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms