REST Resource: forms.responses

Recurso: FormResponse

Una respuesta de 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. Marca de tiempo de la primera vez que se envió la respuesta.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

lastSubmittedTime

string (Timestamp format)

Solo salida. Marca de tiempo de la hora más reciente en la que se envió la respuesta. No realiza un seguimiento de los cambios en las calificaciones.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

respondentEmail

string

Solo salida. Es la dirección de correo electrónico (si se recopila) del encuestado.

answers

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

Solo salida. Las respuestas reales a las preguntas, codificadas 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. La cantidad total de puntos que el encuestado recibió por su entrega. Solo se establece si el formulario es un cuestionario y se califica la respuesta. Esto incluye los puntos otorgados automáticamente mediante la calificación automática que se ajusta según las correcciones manuales ingresadas por 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. La calificación de la respuesta si el formulario es 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 en forma de texto.

fileUploadAnswers

object (FileUploadAnswers)

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

TextAnswers

Son las respuestas de una pregunta en forma de texto.

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

object (TextAnswer)

Solo salida. Respuestas a una pregunta. Para ChoiceQuestion con varios valores, cada respuesta es un valor independiente.

TextAnswer

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 que se usa 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: 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 el año: AAAA-MM-DD, p.ej. “19-05-1986”
    • Con hora: MM-DD HH:MM, p.ej., "05-19 2:51 p.m."
    • Con el año y la hora: AAAA-MM-DD HH:MM, p.ej., “1986-05-19 14:51”
  • TimeQuestion: Es una string 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 una QuestionGroupItem se representa como una Answer independiente. Cada una contendrá una cadena para las opciones de tipo RADIO o varias cadenas para las opciones CHECKBOX.

FileUploadAnswers

Todos los archivos enviados para una pregunta de FileUpload

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

object (FileUploadAnswer)

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

FileUploadAnswer

Información sobre un solo archivo enviado 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. El nombre del archivo, tal como se guardó en Google Drive cuando se subió.

mimeType

string

Solo salida. Es el tipo de 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. Es la puntuación numérica que se otorga a la respuesta.

correct

boolean

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

feedback

object (Feedback)

Solo salida. Comentarios adicionales proporcionados sobre una respuesta.

Métodos

get

Obtén una respuesta del formulario.

list

Enumera las respuestas de un formulario.