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 "Zulu" เช่น "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

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