Method: forms.responses.list

Liệt kê các câu trả lời của một 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

Thông số
formId

string

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

Tham số truy vấn

Thông số
filter

string

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

timestamp > N

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

timestamp >= N

nghĩa là nhận tất cả các câu trả lời 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 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 bằng 0, hệ thống sẽ trả về tối đa 5.000 câu trả lời.
pageToken

string

Mã thông báo trang được trả về bởi một phản hồi danh sách trước đó. Nếu bạn đặt trường này, thì biểu mẫu và các giá trị của bộ lọc phải giống với 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 cho 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ác câu trả lời 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 danh sách.
nextPageToken

string

Nếu bạn đặt, sẽ có thêm các câu trả lời. Để nhận trang phản hồi tiếp theo, hãy cung cấp trang này dưới dạng pageToken trong một 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.