Przegląd

Podział na strony

LSA obsługuje stronicowanie, aby obsługiwać żądania dużych migawek w wielu pobraniach stron. Google będzie pobierać dany punkt końcowy partnera z parametrem maxresults, aby ograniczyć maksymalną liczbę dostawców usług zwracanych w odpowiedzi JSON. Partnerzy wypełnią token stronicowania w polu metadata.pagination.nextTokenParam w odpowiedzi JSON. Wartość tego tokena jest specyficzna dla partnera i służy do tworzenia adresu URL następnej strony. Pole nextTokenParam nie może być wypełnione na ostatniej stronie. Pamiętaj, że obiekt metadata.pagination powinien być zawsze wypełniony (jest wymagany w schemacie), nawet jeśli ostatnia strona nie będzie zawierać pola nextTokenParam. Ponadto totalCount oznacza łączną liczbę usługodawców (lub reviewItems w przypadku pliku danych z opiniami) na wszystkich stronach.

Na przykład jeśli partner ma w pełnej migawce 200 dostawców. Gdy Google rozpocznie przesyłanie plików danych za pomocą adresu URL, http://www.partners.com/feeds/{version}/profile&maxresults=100 pierwsza stronametaData powinna zwrócić pierwszych 100 dostawców usług partnerskich z tymi informacjami:

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

Google przeanalizuje nextTokenParam: "yre7yiesar" i rozpocznie drugi transfer z adresem URL:http:partners.com/feeds/{version}/profile&nextpagetoken=yre7yiesar&maxresults=100

Druga strona powinna zwrócić ostatnich 100 dostawców. Ponieważ druga strona jest też ostatnią, parametr nextTokenParam nie zostanie wypełniony (przykład poniżej), co oznacza koniec paginacji.metaData

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

Pamiętaj, że po pobraniu wszystkich stron łączna liczba serviceProvidersobiektów (na wszystkich stronach) musi być równa liczbie totalCount podanej podczas pobierania pierwszej strony.