REST Resource: forms.responses

资源:FormResponse

表单回复。

JSON 表示法
{
  "formId": string,
  "responseId": string,
  "createTime": string,
  "lastSubmittedTime": string,
  "respondentEmail": string,
  "answers": {
    string: {
      object (Answer)
    },
    ...
  },
  "totalScore": number
}
字段
formId

string

仅供输出。表单 ID。

responseId

string

仅供输出。响应 ID。

createTime

string (Timestamp format)

仅供输出。首次提交回复的时间戳。

时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

lastSubmittedTime

string (Timestamp format)

仅供输出。最近提交回复的时间戳。不跟踪成绩的更改。

时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

respondentEmail

string

仅供输出。回复者的电子邮件地址(如果收集)。

answers

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

仅供输出。问题的实际答案,以 questionId 进行键控。

包含一系列 "key": value 对的对象。示例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

totalScore

number

仅供输出。回复者提交的总分。仅当表单是测验且回复已评分时,才可设置。包括自动评分方式自动给予的分数,这些分数是根据表单所有者手动输入的任何答案而调整的。

答案

针对问题提交的回答。

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.
}
字段
questionId

string

仅供输出。问题的 ID。另请参阅 Question.question_id

grade

object (Grade)

仅供输出。如果该表单是测验,则答案的成绩。

联合字段 value。用户的回答。value 只能是下列其中一项:
textAnswers

object (TextAnswers)

仅供输出。以文本形式提供具体答案。

fileUploadAnswers

object (FileUploadAnswers)

仅供输出。针对文件上传问题的回答。

TextAnswers

以文本形式显示问题的回答。

JSON 表示法
{
  "answers": [
    {
      object (TextAnswer)
    }
  ]
}
字段
answers[]

object (TextAnswer)

仅供输出。对某个问题的回答。对于多值 ChoiceQuestion,每个答案都是一个单独的值。

TextAnswer

以文本形式表示的问题的回答。

JSON 表示法
{
  "value": string
}
字段
value

string

仅供输出。答案值。

不同类型问题所用的格式:

  • ChoiceQuestion
    • RADIODROP_DOWN:与所选选项对应的单个字符串。
    • CHECKBOX:与每个所选选项对应的多个字符串。
  • TextQuestion:用户输入的文本。
  • ScaleQuestion:包含所选数字的字符串。
  • DateQuestion
    • 不包含时间或年份:MM-DD,例如“05-19”
    • 包含年份:YYYY-MM-DD,例如“1986-05-19”
    • 包含时间:MM-DD HH:MM,例如“05-19 14:51”
    • 包含年份和时间:YYYY-MM-DD HH:MM,例如“1986-05-19 14:51”
  • TimeQuestion:包含时间或时长的字符串,采用 HH:MM 格式,例如“14:51”
  • QuestionGroupItem 中的 RowQuestionQuestionGroupItem 每行的答案表示为一个单独的 Answer。每个选项都将包含一个字符串(用于 RADIO 类型的选项)或多个字符串(用于 CHECKBOX 类型的选项)。

FileUploadAnswers

与 FileUpload 问题对应的所有文件。

JSON 表示法
{
  "answers": [
    {
      object (FileUploadAnswer)
    }
  ]
}
字段
answers[]

object (FileUploadAnswer)

仅供输出。与 FileUpload 问题对应的所有文件。

FileUploadAnswer

针对文件上传问题提交的单个文件的信息。

JSON 表示法
{
  "fileId": string,
  "fileName": string,
  "mimeType": string
}
字段
fileId

string

仅供输出。Google 云端硬盘文件的 ID。

fileName

string

仅供输出。文件名,上传时存储在 Google 云端硬盘中。

mimeType

string

仅供输出。文件的 MIME 类型,上传时存储在 Google 云端硬盘中。

成绩

与回复者的问题解答相关联的评分信息。

JSON 表示法
{
  "score": number,
  "correct": boolean,
  "feedback": {
    object (Feedback)
  }
}
字段
score

number

仅供输出。为答案评出的分数。

correct

boolean

仅供输出。问题回答正确与否。零分不足以推断错误,因为正确回答的问题可能价值 0 分。

feedback

object (Feedback)

仅供输出。针对某个答案提供的其他反馈。

方法

get

从表单获取一条回复。

list

列出表单的响应。