Method: forms.responses.list

Liệt kê các 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

Các tham số
formId

string

Bắt buộc. Mã của Biểu mẫu có câu trả lời cho danh sách.

Tham số truy vấn

Các tham số
filter

string

Biểu mẫu nào sẽ trả lời. Hiện tại, các bộ lọc được hỗ trợ duy nhất là:

timestamp > N

có nghĩa là bạn sẽ nhận được tất cả các phản hồi của biểu mẫu sau (nhưng không phải tại) dấu thời gian N. *

timestamp >= N

có nghĩa là bạn sẽ nhận được tất cả các phản hồi về biểu mẫu được gửi vào 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 câu trả lời tối đa cần trả về. Dịch vụ có thể trả lại ít hơn giá trị này. Nếu không được chỉ định hoặc bằng 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 một phản hồi danh sách trước đó trả về. Nếu bạn đặt trường này, thì biểu mẫu và 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 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 của biểu mẫu được trả lại. 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 thì sẽ có nhiều câu trả lời hơn. Để nhận trang phản hồi tiếp theo, hãy cung cấp phản hồi này dưới dạng pageToken trong yêu cầu sau này.

Phạm vi ủy 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 ủy quyền.