Se usó la API de Cloud Translation para traducir esta página.

Class ItemResponse

Una respuesta a un elemento de una pregunta dentro de un formulario. Se puede acceder a las respuestas de los elementos desde FormResponse y crearlas desde cualquier Item que le pida a la persona que responde que responda una pregunta.

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

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`getFeedback()`	`Object`	Obtiene los comentarios que se enviaron para la respuesta enviada por el encuestado.
`getItem()`	`Item`	Obtiene el elemento de la pregunta que responde esta respuesta.
`getResponse()`	`Object`	Obtiene la respuesta que el encuestado envió.
`getScore()`	`Object`	Obtiene la puntuación de la respuesta de los encuestados.
`setFeedback(feedback)`	`ItemResponse`	Establece los comentarios que se deben mostrar para la respuesta enviada por los encuestados.
`setScore(score)`	`ItemResponse`	Establece la puntuación de la respuesta de los encuestados.

Documentación detallada

`getFeedback()`

Obtiene los comentarios que se enviaron para la respuesta enviada por el encuestado.

Volver

Object: Es un QuizFeedback para el elemento de la pregunta.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getItem()`

Obtiene el elemento de la pregunta que responde esta respuesta.

Volver

Item: el elemento de la pregunta que se responde en esta respuesta

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getResponse()`

Obtiene la respuesta que el encuestado envió. Para la mayoría de los tipos de elementos de pregunta, esto muestra un String.

Para las preguntas CheckboxItem, se muestra un arreglo String[] que contiene las opciones de respuesta. El orden de las strings en el arreglo puede variar.

Para las preguntas GridItem, se muestra un arreglo String[] en el que la respuesta en el índice n corresponde a la pregunta en la fila n + 1 de la cuadrícula. Si un encuestado no respondió una pregunta en la cuadrícula, la respuesta se muestra como ''.

Para las preguntas CheckboxGridItem, se muestra un arreglo String[][] en el que las respuestas del índice de fila n corresponden a la pregunta de la fila n + 1 en la cuadrícula de la casilla de verificación. Si el encuestado no respondió una pregunta en la cuadrícula, la respuesta se muestra como ''.

Volver

Object: Un String, String[] o String[][] de respuestas al elemento de la pregunta

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getScore()`

Obtiene la puntuación de la respuesta de los encuestados.

Volver

Object: Es un Double que representa la puntuación del elemento de la pregunta.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`setFeedback(feedback)`

Establece los comentarios que se deben mostrar para la respuesta enviada por los encuestados.

Este método no guarda los comentarios en Formularios hasta que se llama a Form.submitGrades(responses) con los formularios FormResponses actualizados. Consulta setScore() para ver un ejemplo.

Parámetros

Nombre	Tipo	Descripción
`feedback`	`Object`

Volver

ItemResponse: un ItemResponse para el encadenamiento

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`setScore(score)`

Establece la puntuación de la respuesta de los encuestados. Un valor nulo borrará la puntuación existente.

En realidad, este método no guarda la puntuación en Formularios hasta que se llama a Form.submitGrades(responses) con los Formularios de respuesta actualizados.

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

Parámetros

Nombre	Tipo	Descripción
`score`	`Object`

Volver

ItemResponse: un ItemResponse para el encadenamiento

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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