เลื่อนดูรายการทรัพยากร

คุณสามารถควบคุมจํานวนทรัพยากรสูงสุดที่เซิร์ฟเวอร์แสดงในคําตอบสําหรับคําขอรายการได้โดยการตั้งค่าช่อง maxResults นอกจากนี้ สําหรับคอลเล็กชันบางรายการ (เช่น เหตุการณ์) จะมีขีดจํากัดสูงสุดของจํานวนรายการที่ดึงข้อมูลได้ ซึ่งเซิร์ฟเวอร์จะไม่เกินจํานวนนี้ หากจํานวนเหตุการณ์ทั้งหมดเกินจํานวนสูงสุดนี้ เซิร์ฟเวอร์จะแสดงผลลัพธ์ 1 หน้า

โปรดทราบว่า maxResults ไม่ได้รับประกันจํานวนผลลัพธ์ใน 1 หน้า ช่อง nextPageToken ที่ไม่ว่างเปล่าในคําตอบบ่งบอกว่าผลลัพธ์ไม่สมบูรณ์ หากต้องการดึงข้อมูลหน้าถัดไป ให้ทําซ้ําคําขอก่อนหน้าและเพิ่มพารามิเตอร์ pageToken ที่มีค่า nextPageToken จากหน้าก่อนหน้า แต่ละหน้าถัดไปจะมี nextPageToken ใหม่จนกว่าคําตอบจะมีผลลัพธ์ทั้งหมด

ตัวอย่างเช่น คําค้นหาต่อไปนี้จะขอหน้าแรก

GET /calendars/primary/events?maxResults=10&singleEvents=true

คําตอบจะมี nextPageToken ดังนี้

{
  "nextPageToken": "CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA"
}

คําค้นหาถัดไปจะใช้ค่าจาก nextPageToken และส่งเป็นค่าสําหรับ pageToken ดังนี้

GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA