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.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", 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 da hora mais recente em que a resposta foi enviada. Não monitora alterações nas notas.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", 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, classificadas 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. Só é definido se o formulário for um teste e a resposta tiver sido avaliada. Isso inclui os pontos concedidos automaticamente pelas 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 ID da pergunta. Consulte também Question.question_id.
grade

object (Grade)

Apenas saída. A nota da resposta, se o formulário era 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 com upload de arquivo.

TextAnswers

As respostas de uma pergunta como texto.

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

object (TextAnswer)

Apenas saída. Respostas para uma pergunta. Para ChoiceQuestions de valores múltiplos, cada resposta é um valor separado.

TextAnswer

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 que o usuário digitou.
  • 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 "19/05/1986"
    • Com hora: 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 uma QuestionGroupItem é representada como um Answer separado. Cada um vai conter uma string para as opções do tipo RADIO ou várias strings para as opções de 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 de um único arquivo enviado a uma pergunta com upload de arquivo.

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, como 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 da resposta.
correct

boolean

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

object (Feedback)

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

Métodos

get

 Receba uma resposta do formulário.

list

 Listar as respostas de um formulário.