Tổng quan

Phân trang

LSA hỗ trợ phân trang để đáp ứng các yêu cầu về một ảnh chụp nhanh lớn trong nhiều lần tìm nạp (kéo) trang. Google sẽ kéo một điểm cuối đối tác nhất định bằng một tham số maxresults để giới hạn số lượng tối đa nhà cung cấp dịch vụ được trả về trong phản hồi JSON. Các đối tác sẽ điền mã phân trang vào trường metadata.pagination.nextTokenParam trong phản hồi JSON. Giá trị của mã thông báo này dành riêng cho đối tác và được dùng để tạo URL trang tiếp theo. Bạn không được điền vào trường nextTokenParam cho trang cuối cùng. Xin lưu ý rằng đối tượng metadata.pagination phải luôn được điền sẵn (vì đây là đối tượng bắt buộc trong lược đồ), ngay cả khi trang cuối cùng không có trường nextTokenParam. Ngoài ra, totalCount cho biết tổng số nhà cung cấp dịch vụ (hoặc reviewItems trong trường hợp nguồn cấp dữ liệu bài đánh giá) trên tất cả các trang.

Ví dụ: nếu một đối tác có 200 nhà cung cấp trong ảnh chụp nhanh đầy đủ. Khi Google bắt đầu chuyển nguồn cấp dữ liệu bằng URL http://www.partners.com/feeds/{version}/profile&maxresults=100, trang đầu tiên sẽ trả về 100 nhà cung cấp đối tác đầu tiên có metaData sau đây:

"metaData": {
     "feedCategory":"SNAPSHOT",
     "feedTimestampMicros":1532930955190163,
     "apiVersion": "v1",
     "pagination": {
        "nextTokenParam": "yre7yiesar"
     },
     "totalCount":200
}
"serviceProviders": {....}   // Contains 100 service provider objects.

Google sẽ phân tích cú pháp nextTokenParam: "yre7yiesar" và bắt đầu quá trình chuyển thứ hai bằng URL: http:partners.com/feeds/{version}/profile&nextpagetoken=yre7yiesar&maxresults=100

Trang thứ hai sẽ trả về 100 nhà cung cấp gần đây nhất. Vì trang thứ hai cũng là trang cuối cùng, nên nextTokenParam sẽ không được điền sẵn (ví dụ: metaData bên dưới), cho biết đã đến cuối quá trình phân trang.

"metaData": {
     "feedCategory":"SNAPSHOT",
     "feedTimestampMicros":1532930955190164,
     "apiVersion": "v1",
     "pagination": {},
     "totalCount":200
}
"serviceProviders": {....}

Xin lưu ý rằng sau khi tìm nạp tất cả các trang, tổng số đối tượng serviceProviders (trên tất cả các trang) phải bằng totalCount được chỉ ra trong lần tìm nạp trang đầu tiên.