Bạn có thể kiểm soát số lượng tài nguyên tối đa mà máy chủ trả về trong phản hồi cho một yêu cầu danh sách bằng cách đặt trường maxResults. Ngoài ra, đối với một số bộ sưu tập (chẳng hạn như Sự kiện), có một giới hạn cứng về số lượng mục đã truy xuất mà máy chủ sẽ không bao giờ vượt quá. Nếu tổng số sự kiện vượt quá mức tối đa này, máy chủ sẽ trả về một trang kết quả.
Hãy nhớ rằng maxResults không đảm bảo số lượng kết quả trên một trang.
Bạn có thể phát hiện kết quả chưa hoàn chỉnh bằng trường nextPageToken không trống trong kết quả. Để truy xuất trang tiếp theo, hãy thực hiện chính xác yêu cầu như trước đây và thêm trường pageToken có giá trị nextPageToken từ trang trước. nextPageToken mới được cung cấp trên các trang sau cho đến khi tất cả kết quả được truy xuất.
Ví dụ: sau đây là một truy vấn, tiếp theo là truy vấn để truy xuất trang kết quả tiếp theo trong danh sách được phân trang:
GET /calendars/primary/events?maxResults=10&singleEvents=true
//Result contains
"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",
Truy vấn tiếp theo lấy giá trị từ nextPageToken và gửi giá trị đó dưới dạng giá trị cho pageToken:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA