Es una respuesta a un elemento de pregunta dentro de un formulario. Se puede acceder a las respuestas de los elementos desde Form
y crearlas desde cualquier Item
que le solicite 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 muestra | Descripción breve |
---|---|---|
get | Object | Obtiene los comentarios que se proporcionaron para la respuesta enviada del encuestado. |
get | Item | Obtiene el elemento de pregunta que responde esta respuesta. |
get | Object | Obtiene la respuesta que envió el encuestado. |
get | Object | Obtiene la puntuación de la respuesta enviada por el encuestado. |
set | Item | Establece los comentarios que se deben mostrar para la respuesta enviada del encuestado. |
set | Item | Establece la puntuación de la respuesta enviada por el encuestado. |
Documentación detallada
get Feedback()
Obtiene los comentarios que se proporcionaron para la respuesta enviada del encuestado.
Volver
Object
: Es un Quiz
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 ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Item()
Obtiene el elemento de pregunta que responde esta respuesta.
Volver
Item
: Es el elemento de pregunta al 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 ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Response()
Obtiene la respuesta que envió el encuestado. Para la mayoría de los tipos de elementos de pregunta, se muestra un String
.
Para las preguntas Checkbox
, muestra un array String[]
que contiene las opciones del encuestado. El orden de las cadenas en el array puede variar.
En el caso de las preguntas Grid
, se muestra un array 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 de la cuadrícula, esa respuesta se muestra como ''
.
En el caso de las preguntas Checkbox
, se muestra un array 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 cuadros de verificación. Si un encuestado no respondió una pregunta de la cuadrícula, esa respuesta se muestra como ''
.
Volver
Object
: Es un String
, String[]
o String[][]
de respuestas a la pregunta.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Score()
Obtiene la puntuación de la respuesta enviada por el encuestado.
Volver
Object
: Es 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 ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Feedback(feedback)
Establece los comentarios que se deben mostrar para la respuesta enviada del encuestado.
En realidad, este método no guarda los comentarios en Formularios hasta que se llama a Form.submitGrades(responses)
con los FormResponses actualizados. Consulta set
para ver un ejemplo.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
feedback | Object |
Volver
Item
: Un Item
para encadenar
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
set Score(score)
Establece la puntuación de la respuesta enviada por el encuestado. 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 las FormResponses actualizadas.
// 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
Item
: Un Item
para encadenar
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms