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

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