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

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