Class ItemResponse

ItemResponse

Câu trả lời cho một mục câu hỏi trong biểu mẫu. Bạn có thể truy cập vào câu trả lời cho câu hỏi từ FormResponse và tạo câu trả lời từ bất kỳ Item nào yêu cầu người trả lời trả lời một câu hỏi.

// Open a form by ID and log the responses to each question.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const formResponses = form.getResponses();
for (let i = 0; i < formResponses.length; i++) {
  const formResponse = formResponses[i];
  const itemResponses = formResponse.getItemResponses();
  for (let j = 0; j < itemResponses.length; j++) {
    const itemResponse = itemResponses[j];
    Logger.log(
        'Response #%s to the question "%s" was "%s"',
        (i + 1).toString(),
        itemResponse.getItem().getTitle(),
        itemResponse.getResponse(),
    );
  }
}

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
getFeedback()ObjectNhận ý kiến phản hồi đã được đưa ra cho câu trả lời mà người trả lời đã gửi.
getItem()ItemNhận câu hỏi mà câu trả lời này trả lời.
getResponse()ObjectNhận câu trả lời mà người trả lời đã gửi.
getScore()ObjectNhận điểm cho câu trả lời mà người trả lời đã gửi.
setFeedback(feedback)ItemResponseĐặt ý kiến phản hồi sẽ hiển thị cho câu trả lời mà người trả lời đã gửi.
setScore(score)ItemResponseĐặt điểm cho câu trả lời mà người trả lời đã gửi.

Tài liệu chi tiết

getFeedback()

Nhận ý kiến phản hồi đã được đưa ra cho câu trả lời mà người trả lời đã gửi.

Trả về

ObjectQuizFeedback cho câu hỏi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

getItem()

Nhận câu hỏi mà câu trả lời này trả lời.

Trả về

Item – câu hỏi mà câu trả lời này trả lời

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

getResponse()

Nhận câu trả lời mà người trả lời đã gửi. Đối với hầu hết các loại câu hỏi, phương thức này trả về String.

Đối với câu hỏi CheckboxItem, phương thức này trả về một mảng String[] chứa các lựa chọn của người trả lời. Thứ tự của các chuỗi trong mảng có thể thay đổi.

Đối với câu hỏi GridItem, phương thức này trả về một mảng String[] trong đó câu trả lời ở chỉ mục n tương ứng với câu hỏi ở hàng n + 1 trong lưới. Nếu người trả lời không trả lời một câu hỏi trong lưới, thì câu trả lời đó sẽ được trả về dưới dạng ''.

Đối với câu hỏi CheckboxGridItem, phương thức này trả về một mảng String[][] trong đó các câu trả lời ở chỉ mục hàng n tương ứng với câu hỏi ở hàng n + 1 trong lưới hộp kiểm. Nếu người trả lời không trả lời một câu hỏi trong lưới, thì câu trả lời đó sẽ được trả về dưới dạng ''.

Trả về

ObjectString hoặc String[] hoặc String[][] của các câu trả lời cho câu hỏi mục

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

getScore()

Nhận điểm cho câu trả lời mà người trả lời đã gửi.

Trả về

ObjectDouble đại diện cho điểm của câu hỏi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

setFeedback(feedback)

Đặt ý kiến phản hồi sẽ hiển thị cho câu trả lời mà người trả lời đã gửi.

Phương thức này không thực sự lưu ý kiến phản hồi trong Biểu mẫu cho đến khi Form.submitGrades(responses) được gọi bằng FormResponses đã cập nhật. Hãy xem setScore() để biết ví dụ.

Thông số

TênLoạiMô tả
feedbackObject

Trả về

ItemResponseItemResponse để xâu chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

setScore(score)

Đặt điểm cho câu trả lời mà người trả lời đã gửi. Giá trị rỗng sẽ xoá điểm hiện có.

Phương thức này không thực sự lưu điểm trong Biểu mẫu cho đến khi Form.submitGrades(responses) được gọi bằng FormResponses đã cập nhật.

// For a multiple choice question with options: "Always true", "Sometimes true",
// and "Never", award half credit for responses that answered "Sometimes true".
const formResponses = FormApp.getActiveForm().getResponses();
// Go through each form response
for (let i = 0; i < formResponses.length; i++) {
  const response = formResponses[i];
  const items = FormApp.getActiveForm().getItems();
  // Assume it's the first item
  const item = items[0];
  const itemResponse = response.getGradableResponseForItem(item);
  // Give half credit for "Sometimes true".
  if (itemResponse != null && itemResponse.getResponse() === 'Sometimes true') {
    const points = item.asMultipleChoiceItem().getPoints();
    itemResponse.setScore(points * 0.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);

Thông số

TênLoạiMô tả
scoreObject

Trả về

ItemResponseItemResponse để xâu chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền bằng một hoặc nhiều phạm vi sau:

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