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 respuesta.

createTime

string (Timestamp format)

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

Es una marca de tiempo en formato RFC3339 UTC “Zulú”, con 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 hace un seguimiento de los cambios en las calificaciones.

Es una marca de tiempo en formato RFC3339 UTC “Zulú”, con 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. La dirección de correo electrónico (si se recopila) del encuestado.

answers

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

Solo salida. Son las respuestas reales a las preguntas, seguidas de 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ó el encuestado por su envío. Solo se estableció si el formulario era un cuestionario y se calificó la respuesta. Esto incluye los puntos otorgados automáticamente mediante la calificación automática ajustada por cualquier corrección manual que ingrese el propietario del formulario.

Respuesta

Es la respuesta que se envió 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. Es el ID de la pregunta. Consulta también Question.question_id.

grade

object (Grade)

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

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

object (TextAnswers)

Solo salida. Son las respuestas específicas como texto.

fileUploadAnswers

object (FileUploadAnswers)

Solo salida. Las respuestas a una pregunta de carga de archivos.

TextAnswers

Las preguntas se responden como texto.

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

object (TextAnswer)

Solo salida. Respuestas a una pregunta. Para los valores ChoiceQuestion múltiples, cada respuesta es un valor independiente.

TextoRespuesta

Corresponde a 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 utiliza para diferentes tipos de preguntas:

  • ChoiceQuestion
    • RADIO o DROP_DOWN: Es una sola string que corresponde a la opción seleccionada.
    • CHECKBOX: Varias strings correspondientes a cada opción seleccionada.
  • TextQuestion: Es el texto que ingresó el usuario.
  • ScaleQuestion: Es una string 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: MM-DD 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: String con hora o 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 una contendrá una string para las opciones de tipo RADIO o varias strings para las opciones de CHECKBOX.

Subidas de archivos

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

Respuesta

Información de 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. Es el ID del archivo de Google Drive.

fileName

string

Solo salida. El nombre del archivo, tal como se almacenó en Google Drive al momento de la carga.

mimeType

string

Solo salida. El tipo de MIME del archivo, como se almacena en Google Drive al momento de la carga.

Calificación

Califica la informació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 para la respuesta.

correct

boolean

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

feedback

object (Feedback)

Solo salida. Comentarios adicionales para una respuesta.

Métodos

get

Obtén una respuesta del formulario.

list

Enumera las respuestas de un formulario.