Class ItemResponse

ItemResponse

Ответ на один из вопросов в форме. Ответы на вопросы можно получить через FormResponse и создать из любого Item , который просит респондента ответить на вопрос.

// 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(),
    );
  }
}

Методы

Метод Тип возвращаемого значения Краткое описание
get Feedback() Object Получает обратную связь, предоставленную в ответ на представленный респондентом ответ.
get Item() Item Получает вопрос, на который даёт ответ данный ответ.
get Response() Object Получает ответ, предоставленный респондентом.
get Score() Object Получает оценку за ответ, представленный респондентом.
set Feedback(feedback) Item Response Задает параметры обратной связи, которые должны отображаться для ответа, отправленного респондентом.
set Score(score) Item Response Устанавливает оценку для ответа, представленного респондентом.

Подробная документация

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) с обновленными объектами FormResponses. См. пример использования setScore() .

Параметры

Имя Тип Описание
feedback Object

Возвращаться

ItemResponse — объект ItemResponse для создания цепочек вызовов.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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

setScore(score)

Устанавливает оценку для ответа, представленного респондентом. Значение null обнулит существующую оценку.

Этот метод фактически не сохраняет оценку в Forms до тех пор, пока не будет вызван метод 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".
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);

Параметры

Имя Тип Описание
score Object

Возвращаться

ItemResponse — объект ItemResponse для создания цепочек вызовов.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

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