Method: forms.responses.list

แสดงรายการคำตอบของแบบฟอร์ม

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
formId

string

ต้องระบุ รหัสของแบบฟอร์มที่มีคำตอบที่จะแสดง

พารามิเตอร์การค้นหา

พารามิเตอร์
filter

string

คำตอบแบบฟอร์มที่จะแสดงผล ปัจจุบันตัวกรองที่รองรับมีเพียงรายการต่อไปนี้

timestamp > N

ซึ่งหมายถึงการตอบกลับแบบฟอร์มทั้งหมดที่ส่งหลังจาก (แต่ไม่ถึง) การประทับเวลา N *

timestamp >= N

ซึ่งหมายถึงการตอบกลับแบบฟอร์มทั้งหมดที่ส่งที่และหลังจากการประทับเวลา N

สำหรับตัวกรองที่รองรับทั้ง 2 แบบ การประทับเวลาต้องอยู่ในรูปแบบ RFC3339 UTC "ซูลู" เช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

pageSize

integer

จำนวนคำตอบสูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุหรือเป็น 0 ระบบจะแสดงผลคำตอบไม่เกิน 5, 000 รายการ

pageToken

string

โทเค็นของหน้าที่แสดงผลโดยการตอบกลับรายการก่อนหน้า หากตั้งค่าช่องนี้ไว้ แบบฟอร์มและค่าของตัวกรองจะต้องเหมือนกับคำขอเดิม

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

ตอบกลับ ListFormResponsesRequest

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "responses": [
    {
      object (FormResponse)
    }
  ],
  "nextPageToken": string
}
ช่อง
responses[]

object (FormResponse)

การตอบกลับแบบฟอร์มที่แสดงผล หมายเหตุ: ช่อง formId จะไม่แสดงผลในออบเจ็กต์ FormResponse สำหรับคำขอรายการ

nextPageToken

string

หากตั้งค่าไว้ คำตอบมีมากกว่านี้ หากต้องการรับหน้าถัดไปของคำตอบ ให้ระบุ pageToken ในคำขอในอนาคต

ขอบเขตการให้สิทธิ์

ต้องมีขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

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

โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์