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

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