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 em 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 da hora mais recente em que a resposta foi enviada. Não rastreia mudanças 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, inseridas 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 pelo envio. Defina apenas se o formulário for um teste e a resposta tiver sido avaliada. Isso inclui os pontos concedidos automaticamente pelas notas automáticas e 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 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 a uma pergunta sobre upload de arquivo.

TextAnswers

São as respostas de uma pergunta como texto.

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

object (TextAnswer)

Apenas saída. Respostas a uma pergunta. Para ChoiceQuestions de 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 que o usuário digitou.
  • ScaleQuestion: uma string contendo o número selecionado.
  • DateQuestion
    • Sem data 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 horário 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 um terá uma string para as opções do tipo RADIO ou várias strings para as opções do CHECKBOX.

FileUploadAnswers

Todos os arquivos enviados para uma pergunta do FileUpload.

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

object (FileUploadAnswer)

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

FileUploadAnswer

Informações de um único arquivo enviado a uma pergunta de 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 durante o upload.

Nota

Atribuir notas 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, pois 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

Liste as respostas de um formulário.