此页面由 Cloud Translation API 翻译。

Class ItemResponse

对表单中的一个问题项的响应。您可以通过 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()`

获取此回答所回答的问题。

Item - 此回答所回答的问题

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

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

`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