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