REST Resource: forms.responses

Recurso: FormResponse

Una respuesta del formulario.

Representación JSON
{
  "formId": string,
  "responseId": string,
  "createTime": string,
  "lastSubmittedTime": string,
  "respondentEmail": string,
  "answers": {
    string: {
      object (Answer)
    },
    ...
  },
  "totalScore": number
}
Campos
formId

string

Solo salida. El ID del formulario.

responseId

string

Solo salida. El ID de la respuesta.

createTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la primera vez que se envió la respuesta.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

lastSubmittedTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la última vez que se envió la respuesta. No realiza un seguimiento de los cambios en las calificaciones.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

respondentEmail

string

Solo salida. Es la dirección de correo electrónico (si se recopiló) de quien responde.

answers

map (key: string, value: object (Answer))

Solo salida. Las respuestas reales a las preguntas, ordenadas por questionId.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

totalScore

number

Solo salida. Es la cantidad total de puntos que recibió la persona que respondió por su envío. Solo se establece si el formulario era un cuestionario y la respuesta se calificó. Esto incluye los puntos otorgados automáticamente mediante la calificación automática, ajustados por las correcciones manuales que ingresó el propietario del formulario.

Respuesta

Es la respuesta enviada para una pregunta.

Representación JSON
{
  "questionId": string,
  "grade": {
    object (Grade)
  },

  // Union field value can be only one of the following:
  "textAnswers": {
    object (TextAnswers)
  },
  "fileUploadAnswers": {
    object (FileUploadAnswers)
  }
  // End of list of possible types for union field value.
}
Campos
questionId

string

Solo salida. El ID de la pregunta. Consulta también Question.question_id.

grade

object (Grade)

Solo salida. Es la calificación de la respuesta si el formulario era un cuestionario.

Campo de unión value. La respuesta del usuario. Las direcciones (value) solo pueden ser una de las siguientes opciones:
textAnswers

object (TextAnswers)

Solo salida. Las respuestas específicas como texto

fileUploadAnswers

object (FileUploadAnswers)

Solo salida. Son las respuestas a una pregunta de carga de archivos.

TextAnswers

Las respuestas de una pregunta como texto.

Representación JSON
{
  "answers": [
    {
      object (TextAnswer)
    }
  ]
}
Campos
answers[]

object (TextAnswer)

Solo salida. Responde una pregunta. En el caso de los ChoiceQuestion de varios valores, cada respuesta es un valor independiente.

TextAnswer

Es una respuesta a una pregunta representada como texto.

Representación JSON
{
  "value": string
}
Campos
value

string

Solo salida. Es el valor de la respuesta.

Formato utilizado para diferentes tipos de preguntas:

  • ChoiceQuestion
    • RADIO o DROP_DOWN: Es una sola cadena que corresponde a la opción que se seleccionó.
    • CHECKBOX: Varias cadenas correspondientes a cada opción que se seleccionó.
  • TextQuestion: Es el texto que ingresó el usuario.
  • ScaleQuestion: Es una cadena que contiene el número que se seleccionó.
  • DateQuestion
    • Sin hora ni año: MM-DD, p.ej., "05-19"
    • Con año: AAAA-MM-DD, p.ej., "1986-05-19"
    • Con hora: DD/MM HH:MM, p.ej., "05-19 14:51"
    • Con año y hora: AAAA-MM-DD HH:MM, p.ej., "1986-05-19 14:51"
  • TimeQuestion: Es una cadena con la hora o la duración en formato HH:MM, p. ej., "14:51".
  • RowQuestion dentro de QuestionGroupItem: La respuesta para cada fila de un QuestionGroupItem se representa como un Answer independiente. Cada uno contendrá una cadena para las opciones de tipo RADIO o varias cadenas para las opciones de CHECKBOX.

FileUploadAnswers

Todos los archivos enviados para una pregunta de carga de archivos

Representación JSON
{
  "answers": [
    {
      object (FileUploadAnswer)
    }
  ]
}
Campos
answers[]

object (FileUploadAnswer)

Solo salida. Todos los archivos enviados para una pregunta de carga de archivos

FileUploadAnswer

Información de un solo archivo que se envió a una pregunta de carga de archivos.

Representación JSON
{
  "fileId": string,
  "fileName": string,
  "mimeType": string
}
Campos
fileId

string

Solo salida. El ID del archivo de Google Drive.

fileName

string

Solo salida. Es el nombre del archivo, tal como se almacena en Google Drive cuando se sube.

mimeType

string

Solo salida. Es el tipo MIME del archivo, tal como se almacena en Google Drive cuando se sube.

Calificación

Información de calificación asociada con la respuesta de un encuestado a una pregunta.

Representación JSON
{
  "score": number,
  "correct": boolean,
  "feedback": {
    object (Feedback)
  }
}
Campos
score

number

Solo salida. La puntuación numérica otorgada por la respuesta.

correct

boolean

Solo salida. Si la pregunta se respondió correctamente o no. Una puntuación de cero puntos no es suficiente para inferir que una respuesta es incorrecta, ya que una pregunta respondida correctamente podría tener un valor de cero puntos.

feedback

object (Feedback)

Solo salida. Se proporcionaron comentarios adicionales para una respuesta.

Métodos

get

Obtén una respuesta del formulario.

list

Muestra una lista de las respuestas de un formulario.