REST Resource: forms.responses

Recurso: FormResponse

Uma resposta de formulário.

Representação JSON 
{
  "formId": string,
  "responseId": string,
  "createTime": string,
  "lastSubmittedTime": string,
  "respondentEmail": string,
  "answers": {
    string: {
      object (Answer)
    },
    ...
  },
  "totalScore": number
}
Campos
formId

string

Apenas saída. O ID do formulário.
responseId

string

Apenas saída. O ID da resposta.
createTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora da primeira vez que a resposta foi enviada.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
lastSubmittedTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora da última vez em que a resposta foi enviada. Não rastreia mudanças nas notas.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
respondentEmail

string

Apenas saída. O endereço de e-mail (se coletado) do participante.
answers

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

Apenas saída. As respostas reais às perguntas, com chave de questionId.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
totalScore

number

Apenas saída. O número total de pontos que o participante recebeu pelo envio Só defina se o formulário foi um teste e a resposta foi avaliada. Isso inclui pontos concedidos automaticamente pela correção automática ajustados por correções manuais inseridas pelo proprietário do formulário.

Resposta

A resposta enviada para uma pergunta.

Representação 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

Apenas saída. O ID da pergunta. Consulte também Question.question_id.
grade

object (Grade)

Apenas saída. A nota da resposta, se o formulário foi um teste.
Campo de união value. A resposta do usuário. value pode ser apenas de um dos tipos a seguir:
textAnswers

object (TextAnswers)

Apenas saída. As respostas específicas como texto.
fileUploadAnswers

object (FileUploadAnswers)

Apenas saída. As respostas a uma pergunta de upload de arquivos.

TextAnswers

A resposta de uma pergunta como texto.

Representação JSON 
{
  "answers": [
    {
      object (TextAnswer)
    }
  ]
}
Campos
answers[]

object (TextAnswer)

Apenas saída. Respostas a uma pergunta. Para ChoiceQuestions com vários valores, cada resposta é um valor separado.

TextAnswer

Uma resposta a uma pergunta representada como texto.

Representação JSON 
{
  "value": string
}
Campos
value

string

Apenas saída. O valor da resposta.

Formatação usada para diferentes tipos de pergunta:

  • ChoiceQuestion
    • RADIO ou DROP_DOWN: uma única string correspondente à opção selecionada.
    • CHECKBOX: várias strings correspondentes a cada opção selecionada.
  • TextQuestion: o texto inserido pelo usuário.
  • ScaleQuestion: uma string que contém o número selecionado.
  • DateQuestion
    • Sem hora ou ano: MM-DD, por exemplo, "05-19"
    • Com ano: AAAA-MM-DD, por exemplo, "1986-05-19"
    • Com horário: MM-DD HH:MM, por exemplo, "05-19 14:51"
    • Com ano e hora: AAAA-MM-DD HH:MM, por exemplo, "1986-05-19 14:51"
  • TimeQuestion: string com hora ou duração no formato HH:MM, por exemplo, "14:51"
  • RowQuestion em QuestionGroupItem: a resposta para cada linha de um QuestionGroupItem é representada como um Answer separado. Cada uma vai conter uma string para opções do tipo RADIO ou várias strings para opções CHECKBOX.

FileUploadAnswers

Todos os arquivos enviados para uma pergunta FileUpload.

Representação JSON 
{
  "answers": [
    {
      object (FileUploadAnswer)
    }
  ]
}
Campos
answers[]

object (FileUploadAnswer)

Apenas saída. Todos os arquivos enviados para uma pergunta FileUpload.

FileUploadAnswer

Informações sobre um único arquivo enviado para uma pergunta de upload de arquivos.

Representação JSON 
{
  "fileId": string,
  "fileName": string,
  "mimeType": string
}
Campos
fileId

string

Apenas saída. O ID do arquivo do Google Drive.
fileName

string

Apenas saída. O nome do arquivo, conforme armazenado no Google Drive no upload.
mimeType

string

Apenas saída. O tipo MIME do arquivo, conforme armazenado no Google Drive no upload.

Nota

Informações de nota associadas à resposta de um participante a uma pergunta.

Representação JSON 
{
  "score": number,
  "correct": boolean,
  "feedback": {
    object (Feedback)
  }
}
Campos
score

number

Apenas saída. A pontuação numérica atribuída à resposta.
correct

boolean

Apenas saída. Se a pergunta foi respondida corretamente ou não. Uma pontuação de zero pontos não é suficiente para inferir incorreção, já que uma pergunta respondida corretamente pode valer zero pontos.
feedback

object (Feedback)

Apenas saída. Feedback adicional dado para uma resposta.

Métodos

get

 Receber uma resposta do formulário.

list

 Listar as respostas de um formulário.