Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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 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
các mục nhập đã truy xuất mà máy chủ sẽ không bao giờ vượt quá. Nếu tổng số
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 đầy đủ bằng một 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ư vậy
như trước đó và thêm trường pageToken có giá trị là
nextPageToken từ trang trước. Đã cung cấp một nextPageToken mới
trên các trang tiếp theo cho đến khi truy xuất tất cả kết quả.
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 nó dưới dạng giá trị cho pageToken:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA