REST Resource: forms.responses

Tài nguyên: FormResponse

Câu trả lời của biểu mẫu.

Biểu diễn dưới dạng JSON
{
  "formId": string,
  "responseId": string,
  "createTime": string,
  "lastSubmittedTime": string,
  "respondentEmail": string,
  "answers": {
    string: {
      object (Answer)
    },
    ...
  },
  "totalScore": number
}
Trường
formId

string

Chỉ có đầu ra. Mã biểu mẫu.

responseId

string

Chỉ có đầu ra. Mã phản hồi.

createTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian của lần đầu tiên gửi phản hồi.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

lastSubmittedTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian của lần gần đây nhất bạn gửi phản hồi. Không theo dõi các thay đổi đối với điểm số.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

respondentEmail

string

Chỉ có đầu ra. Địa chỉ email (nếu được thu thập) của người trả lời.

answers

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

Chỉ có đầu ra. Câu trả lời thực tế cho các câu hỏi, được khoá bằng questionId.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

totalScore

number

Chỉ có đầu ra. Tổng số điểm mà người trả lời nhận được cho nội dung họ gửi. Chỉ đặt nếu biểu mẫu là bài kiểm tra và câu trả lời được chấm điểm. Điểm này bao gồm cả điểm được tự động thưởng thông qua tính năng chấm điểm tự động, được điều chỉnh theo mọi điểm sửa lỗi thủ công mà chủ sở hữu biểu mẫu nhập.

Trả lời

Câu trả lời đã gửi cho một câu hỏi.

Biểu diễn dưới dạng 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.
}
Trường
questionId

string

Chỉ có đầu ra. Mã của câu hỏi. Xem thêm Question.question_id.

grade

object (Grade)

Chỉ có đầu ra. Điểm cho câu trả lời nếu biểu mẫu là bài kiểm tra.

Trường hợp hợp nhất value. Câu trả lời của người dùng. value chỉ có thể là một trong những giá trị sau:
textAnswers

object (TextAnswers)

Chỉ có đầu ra. Câu trả lời cụ thể ở dạng văn bản.

fileUploadAnswers

object (FileUploadAnswers)

Chỉ có đầu ra. Câu trả lời cho câu hỏi về việc tải tệp lên.

TextAnswers

Câu trả lời của một câu hỏi dưới dạng văn bản.

Biểu diễn dưới dạng JSON
{
  "answers": [
    {
      object (TextAnswer)
    }
  ]
}
Trường
answers[]

object (TextAnswer)

Chỉ có đầu ra. Câu trả lời cho một câu hỏi. Đối với ChoiceQuestion có nhiều giá trị, mỗi câu trả lời là một giá trị riêng biệt.

TextAnswer

Câu trả lời cho một câu hỏi được biểu thị dưới dạng văn bản.

Biểu diễn dưới dạng JSON
{
  "value": string
}
Trường
value

string

Chỉ có đầu ra. Giá trị câu trả lời.

Định dạng được dùng cho các loại câu hỏi:

  • ChoiceQuestion
    • RADIO hoặc DROP_DOWN: Một chuỗi duy nhất tương ứng với tuỳ chọn đã chọn.
    • CHECKBOX: Nhiều chuỗi tương ứng với từng tuỳ chọn đã chọn.
  • TextQuestion: Văn bản mà người dùng đã nhập.
  • ScaleQuestion: Một chuỗi chứa số đã được chọn.
  • DateQuestion
    • Không có giờ hoặc năm: MM-DD, ví dụ: "05-19"
    • Có năm: YYYY-MM-DD, ví dụ: "1986-05-19"
    • Có thời gian: MM-DD HH:MM, ví dụ: "05-19 14:51"
    • Có năm và giờ: YYYY-MM-DD HH:MM, ví dụ: "1986-05-19 14:51"
  • TimeQuestion: Chuỗi có thời gian hoặc thời lượng ở định dạng HH:MM, ví dụ: "14:51"
  • RowQuestion trong QuestionGroupItem: Câu trả lời cho mỗi hàng của QuestionGroupItem được biểu thị dưới dạng một Answer riêng biệt. Mỗi sẽ chứa một chuỗi cho các lựa chọn kiểu RADIO hoặc nhiều chuỗi cho các lựa chọn CHECKBOX.

FileUploadAnswers

Tất cả tệp đã gửi cho câu hỏi FileUpload.

Biểu diễn dưới dạng JSON
{
  "answers": [
    {
      object (FileUploadAnswer)
    }
  ]
}
Trường
answers[]

object (FileUploadAnswer)

Chỉ có đầu ra. Tất cả tệp đã gửi cho câu hỏi FileUpload.

FileUploadAnswer

Thông tin về một tệp được gửi cho câu hỏi tải tệp lên.

Biểu diễn dưới dạng JSON
{
  "fileId": string,
  "fileName": string,
  "mimeType": string
}
Trường
fileId

string

Chỉ có đầu ra. Mã của tệp trên Google Drive.

fileName

string

Chỉ có đầu ra. Tên tệp được lưu trữ trong Google Drive khi tải lên.

mimeType

string

Chỉ có đầu ra. Loại MIME của tệp, được lưu trữ trong Google Drive khi tải lên.

Điểm

Thông tin về điểm số liên kết với câu trả lời của người trả lời cho một câu hỏi.

Biểu diễn dưới dạng JSON
{
  "score": number,
  "correct": boolean,
  "feedback": {
    object (Feedback)
  }
}
Trường
score

number

Chỉ có đầu ra. Điểm số dạng số được thưởng cho câu trả lời.

correct

boolean

Chỉ có đầu ra. Liệu câu hỏi có được trả lời đúng hay không. Điểm số bằng 0 không đủ để suy luận rằng câu trả lời là sai, vì một câu hỏi được trả lời chính xác có thể có giá trị bằng 0.

feedback

object (Feedback)

Chỉ có đầu ra. Ý kiến phản hồi bổ sung cho một câu trả lời.

Phương thức

get

Nhận một câu trả lời từ biểu mẫu.

list

Liệt kê các câu trả lời của một biểu mẫu.