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

คุณสามารถควบคุมจำนวนทรัพยากรสูงสุดที่เซิร์ฟเวอร์จะส่งคืนในการตอบสนองคำขอรายการได้โดยการตั้งค่าช่อง 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