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. Ngoài ra, đối với một số tập hợp (chẳng hạn như sự kiện), có một giới hạn cố định về số lượng mục đã truy xuất mà máy chủ 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ả.

Xin lưu ý 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 phản hồi cho biết kết quả chưa hoàn chỉnh. Để truy xuất trang tiếp theo, hãy lặp lại yêu cầu trước đó và thêm một tham số pageToken có giá trị nextPageToken từ trang trước. Mỗi trang tiếp theo sẽ cung cấp một nextPageToken mới cho đến khi phản hồi chứa tất cả kết quả.

Ví dụ: truy vấn sau đây yêu cầu trang đầu tiên:

GET /calendars/primary/events?maxResults=10&singleEvents=true

Phản hồi chứa một nextPageToken:

{
  "nextPageToken": "CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA"
}

Truy vấn tiếp theo lấy giá trị từ nextPageToken và gửi giá trị đó làm giá trị cho pageToken:

GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA