คุณสามารถควบคุมจำนวนทรัพยากรสูงสุดที่เซิร์ฟเวอร์จะส่งคืนในการตอบสนองคำขอรายการได้โดยการตั้งค่าช่อง maxResults
นอกจากนี้ สำหรับคอลเล็กชันบางส่วน (เช่น เหตุการณ์) จะมีขีดจำกัดอย่างเคร่งครัดสำหรับจำนวนรายการที่ดึงมาซึ่งเซิร์ฟเวอร์จะไม่เกินจำนวน หากจำนวนเหตุการณ์ทั้งหมดเกินค่าสูงสุดนี้ เซิร์ฟเวอร์จะแสดงผลการค้นหา 1 หน้า
โปรดทราบว่า maxResults
ไม่ได้รับประกันจำนวนผลการค้นหาในหน้าเดียว
ช่อง nextPageToken
ที่ไม่ว่างเปล่าในผลลัพธ์จะตรวจหาผลลัพธ์ที่ไม่สมบูรณ์ได้ หากต้องการเรียกข้อมูลหน้าถัดไป ให้ดำเนินการตามคำขอเดียวกันกับก่อนหน้านี้ แล้วเติมค่าในช่อง pageToken
ด้วยค่า nextPageToken
จากหน้าก่อนหน้า จะมีการระบุ nextPageToken
ใหม่ในหน้าต่อไปนี้จนกว่าจะดึงผลลัพธ์ทั้งหมดได้
ตัวอย่างเช่น นี่คือคำค้นหาที่ตามด้วยคำค้นหาสำหรับเรียกผลลัพธ์หน้าถัดไปในรายการที่ใส่เลขหน้า
GET /calendars/primary/events?maxResults=10&singleEvents=true
//Result contains
"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",
การค้นหาลำดับต่อมาจะใช้ค่าจาก nextPageToken
และส่งเป็นค่าสำหรับ pageToken
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA