REST Resource: forms.responses

Recurso: FormResponse

Uma resposta ao 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.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

lastSubmittedTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora do momento mais recente em que a resposta foi enviada. Não acompanha alterações nas notas.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

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, apresentadas por 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 no envio. Ele só será definido se o formulário for um teste e a resposta tiver sido corrigida. Isso inclui pontos concedidos automaticamente por meio de notas automáticas ajustadas 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 código da pergunta. Consulte também Question.question_id.

grade

object (Grade)

Apenas saída. A nota da resposta se o formulário for 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 para uma pergunta de upload de arquivo.

Respostas de texto

As respostas de uma pergunta como texto.

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

object (TextAnswer)

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

Resposta de texto

É a 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 horário: 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 conterá uma string para opções do tipo RADIO ou várias strings para opções do CHECKBOX.

FileUploadAnswers

Todos os arquivos enviados para uma pergunta do tipo Upload de arquivo.

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

object (FileUploadAnswer)

Apenas saída. Todos os arquivos enviados para uma pergunta do tipo Upload de arquivo.

Resposta ao upload de arquivo

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

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

string

Apenas saída. O código 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

Atribua notas às informações 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 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 deduzir a incorreção, já que uma pergunta respondida corretamente pode valer zero.

feedback

object (Feedback)

Apenas saída. Feedback adicional fornecido como resposta.

Métodos

get

Receba uma resposta do formulário.

list

Lista as respostas de um formulário.