Class ItemResponse

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)

設定作答者提交答案應顯示的意見回饋。

除非使用更新的表單回應呼叫 Form.submitGrades(responses)，否則這個方法實際上不會將表單意見回饋儲存在 Google 表單中。如需範例，請參閱 setScore()。

參數

名稱	類型	說明
feedback	Object

回攻員

ItemResponse — 用於鏈結的 ItemResponse

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權：

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

---

setScore(score)

設定作答者所提交答案的分數。空值會清除現有分數。

除非使用更新的表單回應呼叫 Form.submitGrades(responses)，否則這個方法實際上不會將分數儲存在表單中。

// 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