Una respuesta a una pregunta dentro de un formulario. Se puede acceder a las respuestas a los elementos en FormResponse
y se pueden crear desde cualquier Item
que solicite al encuestado 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 brindaron sobre la respuesta que envió el encuestado. |
getItem() | Item | Obtiene el elemento de la pregunta que responde esta respuesta. |
getResponse() | Object | Obtiene la respuesta que envió el encuestado. |
getScore() | Object | Obtiene la puntuación de la respuesta que envió el encuestado. |
setFeedback(feedback) | ItemResponse | Establece los comentarios que se deben mostrar para la respuesta enviada por el encuestado. |
setScore(score) | ItemResponse | Establece la puntuación de la respuesta enviada por el encuestado. |
Documentación detallada
getFeedback()
Obtiene los comentarios que se brindaron sobre la respuesta que envió el encuestado.
Devolvedor
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.
Devolvedor
Item
: Es el elemento de la 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 pregunta, esto muestra un String
.
Para las preguntas CheckboxItem
, se muestra un array String[]
que contiene las opciones de la persona que responde. El orden de las cadenas de la matriz puede variar.
Para las preguntas GridItem
, esto 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 en la cuadrícula, esa respuesta se muestra como ''
.
Para las preguntas CheckboxGridItem
, esto muestra un array String[][]
en el que las respuestas en el índice de fila n
corresponden a la pregunta en la fila n + 1
en la cuadrícula de casillas de verificación. Si el encuestado no respondió una pregunta de la cuadrícula, esa respuesta se devuelve como ''
.
Devolvedor
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 que envió el encuestado.
Devolvedor
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 el 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 setScore()
para ver un ejemplo.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
feedback | Object |
Devolvedor
ItemResponse
: Es un ItemResponse
para 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 enviada por el 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". 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 |
Devolvedor
ItemResponse
: Es un ItemResponse
para 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