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

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

โปรดทราบว่า 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