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

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