Class ItemResponse

ItemResponse

Es una respuesta a un elemento de pregunta dentro de un formulario. Se puede acceder a las respuestas de los elementos desde FormResponse y crearlas desde cualquier Item que le pida al encuestado que responda una pregunta.

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

Métodos

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

Documentación detallada

getFeedback()

Obtiene los comentarios que se proporcionaron sobre la respuesta enviada por el encuestado.

Volver

Object: Un QuizFeedback para el elemento de 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 pregunta que responde esta respuesta.

Volver

Item: Es el elemento de pregunta que responde 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 envió el encuestado. Para la mayoría de los tipos de elementos de preguntas, se devuelve un objeto String.

Para las preguntas de CheckboxItem, se devuelve un array de String[] que contiene las elecciones del encuestado. El orden de las cadenas en el array puede variar.

En el caso de las preguntas de GridItem, se devuelve un array de 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, esa respuesta se devuelve como ''.

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

Volver

Object: Es un String, String[] o String[][] de respuestas al elemento de 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 enviada por el encuestado.

Volver

Object: Un Double que representa la puntuación del elemento de 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 del encuestado.

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

Parámetros

Nombre	Tipo	Descripción
feedback	Object

Volver

ItemResponse: Un ItemResponse para encadenar

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 para la respuesta enviada del encuestado. Un valor nulo borrará la puntuación existente.

Este método no guarda la puntuación en Formularios hasta que se llama a Form.submitGrades(responses) con los FormResponses actualizados.

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

Parámetros

Nombre	Tipo	Descripción
score	Object

Volver

ItemResponse: Un ItemResponse para encadenar

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