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
. Hơn nữa, đối với một số bộ sưu tập (chẳng hạn như Sự kiện), có giới hạn cố định về số lượng mục nhập 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.
Có thể phát hiện kết quả không 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 yêu cầu giống hệt như trước và thêm trường pageToken
có giá trị nextPageToken
từ trang trước. nextPageToken
mới sẽ được cung cấp trên các trang tiếp theo cho đến khi tất cả kết quả được truy xuất.
Ví dụ: đây là một truy vấn, theo sau 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 dưới dạng giá trị cho pageToken
:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA