Duyệt qua danh sách các tài nguyê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 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), máy chủ sẽ không bao giờ vượt quá giới hạn cứng về số mục nhập được truy xuất. 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 và thêm trường pageToken có giá trị là nextPageToken từ trang trước. Một 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, theo sau là truy vấn để truy xuất trang kết quả tiếp theo trong danh sách 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