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)

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

使用 RFC 3339，其中生成的输出将始终采用 Z 归一化，并使用 0、3、6 或 9 个小数位。也接受除“Z”以外的偏移量。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
lastSubmittedTime

string (Timestamp format)

仅限输出。上次提交回复时的时间戳。不会跟踪成绩的更改。

使用 RFC 3339，其中生成的输出将始终采用 Z 归一化，并使用 0、3、6 或 9 个小数位。也接受除“Z”以外的偏移量。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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
    • RADIO 或 DROP_DOWN：与所选选项对应的单个字符串。
    • CHECKBOX：与所选的每个选项对应的多个字符串。
  • TextQuestion：用户输入的文本。
  • ScaleQuestion：包含所选号码的字符串。
  • DateQuestion
    • 不含时间或年份：MM-DD，例如“05-19”
    • 包含年份：YYYY-MM-DD，例如“1986-05-19”
    • 包含时间：年-月-日 HH:MM，例如“05-19 14:51”
    • 包含年份和时间：YYYY-MM-DD HH:MM，例如“1986-05-19 14:51”
  • TimeQuestion：采用 HH:MM 格式表示时间或时长的字符串，例如“14:51”
  • QuestionGroupItem 中的 RowQuestion：QuestionGroupItem 的每一行的答案都表示为单独的 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

仅限输出。题目是否回答正确。得分为零不足以推断答案错误，因为正确答案也可能得零分。
feedback

object (Feedback)

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

方法

get

 获取表单中的一条回复。

list

 列出表单的回复。