Method: forms.responses.list

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

Yêu cầu HTTP

GET https://forms.googleapis.com/v1/forms/{formId}/responses

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
formId

string

Bắt buộc. Mã của Biểu mẫu có các câu trả lời được liệt kê.

Tham số truy vấn

Tham số
filter

string

Biểu mẫu nào cần trả về câu trả lời. Hiện tại, chúng tôi chỉ hỗ trợ các bộ lọc sau:

timestamp > N

tức là nhận tất cả câu trả lời trong biểu mẫu được gửi sau (nhưng không phải tại) dấu thời gian N. *

timestamp >= N

tức là nhận tất cả câu trả lời trong biểu mẫu được gửi tại và sau dấu thời gian N.

Đối với cả hai bộ lọc được hỗ trợ, dấu thời gian phải được định dạng theo định dạng "Zulu" RFC3339 (giờ UTC) . Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
pageSize

integer

Số lượng phản hồi tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu không chỉ định hoặc không thì hệ thống sẽ trả về tối đa 5.000 phản hồi.
pageToken

string

Mã thông báo trang được phản hồi trước đó cho danh sách trả về. Nếu bạn đặt trường này, biểu mẫu và các giá trị của bộ lọc phải giống như yêu cầu ban đầu.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Phản hồi một ListFormResponsesRequest.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "responses": [
    {
      object (FormResponse)
    }
  ],
  "nextPageToken": string
}
Trường
responses[]

object (FormResponse)

Câu trả lời trong biểu mẫu được trả về. Lưu ý: Trường formId không được trả về trong đối tượng FormResponse cho các yêu cầu về danh sách.
nextPageToken

string

Nếu bạn đặt chính sách này, sẽ có thêm nhiều câu trả lời khác. Để nhận trang phản hồi tiếp theo, hãy cung cấp dưới dạng pageToken trong yêu cầu trong tương lai.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/forms.responses.readonly

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.