Class ItemResponse

ItemResponse

การตอบคำถาม 1 ข้อในแบบฟอร์ม คำตอบของรายการจะเข้าถึงได้จาก 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()

รับความคิดเห็นที่ได้รับสำหรับคำตอบที่ส่งของผู้ตอบ

รีเทิร์น

ObjectQuizFeedback สำหรับรายการคำถาม

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getItem()

รับรายการคำถามที่คำตอบนี้ตอบ

รีเทิร์น

Item — รายการคำถามที่คำตอบนี้ตอบ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • 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 ในตารางกริดช่องทำเครื่องหมาย หากผู้ตอบไม่ได้ตอบคำถามในตาราง คำตอบนั้นจะแสดงเป็น ''

รีเทิร์น

ObjectString หรือ String[] หรือ String[][] ของคำตอบของคำถาม

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getScore()

รับคะแนนสำหรับคำตอบที่ส่งของผู้ตอบ

รีเทิร์น

ObjectDouble ที่แสดงคะแนนของรายการคำถาม

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setFeedback(feedback)

ตั้งค่าความคิดเห็นที่ควรจะแสดงสำหรับคำตอบที่ส่งของผู้ตอบ

เมธอดนี้จะไม่บันทึกความคิดเห็นในฟอร์มจริงๆ จนกว่าจะมีการเรียก Form.submitGrades(responses) ด้วย FormResponses ที่อัปเดตแล้ว ดูตัวอย่างได้ที่ setScore()

พารามิเตอร์

ชื่อTypeคำอธิบาย
feedbackObject

รีเทิร์น

ItemResponseItemResponse สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setScore(score)

กำหนดคะแนนสำหรับคำตอบที่ส่งของผู้ตอบ ค่า Null จะล้างคะแนนที่มีอยู่

เมธอดนี้จะไม่บันทึกคะแนนในแบบฟอร์มจริงๆ จนกว่าจะมีการเรียกใช้ Form.submitGrades(responses) ด้วย FormResponses ที่อัปเดต

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
scoreObject

รีเทิร์น

ItemResponseItemResponse สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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