Class ItemResponse

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.
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étodoTipo de datos que se muestraDescripción breve
getFeedback()ObjectObtiene los comentarios que se enviaron para la respuesta enviada por el encuestado.
getItem()ItemObtiene el elemento de la pregunta que responde esta respuesta.
getResponse()ObjectObtiene la respuesta que el encuestado envió.
getScore()ObjectObtiene la puntuación de la respuesta de los encuestados.
setFeedback(feedback)ItemResponseEstablece los comentarios que se deben mostrar para la respuesta enviada por los encuestados.
setScore(score)ItemResponseEstablece 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

NombreTipoDescripción
feedbackObject

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

NombreTipoDescripción
scoreObject

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