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 quá trình phản hồi 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 đượ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. Trường nextPageToken không trống trong kết quả có thể phát hiện các kết quả không hoàn chỉnh. Để truy xuất trang tiếp theo, hãy thực hiện yêu cầu tương tự như trước đó 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 đây 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 một 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 sẽ 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