Method: forms.responses.list

Liệt kê phản hồ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

Các tham số
formId

string

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

Tham số truy vấn

Các tham số
filter

string

Câu trả lời trong 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

tức là nhận tất cả câu trả lời trong biểu mẫu được gửi sau dấu thời gian (nhưng không phải tại) 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 UTC. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
pageSize

integer

Số câu trả lờ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 trả về 0, 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 danh sách trước đó 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 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 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
}
Các trường
responses[]

object (FormResponse)

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

string

Nếu được đặt, sẽ có nhiều phản hồi hơn. Để chuyển đến trang câu trả lời tiếp theo, hãy cung cấp nội dung 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.