Genel bakış

Sayfalara ayırma

LSA, çok sayfalı getirme işlemlerinde (çekme) büyük bir anlık görüntü isteğini karşılamak için sayfalara ayırmayı destekler. Google, JSON yanıtında döndürülen serviceProvider'ların maksimum sayısını sınırlamak için bir param maxresults ile belirli bir iş ortağı uç noktasını çeker. İş ortakları, JSON yanıtındaki metadata.pagination.nextTokenParam alanına bir sayfalama jetonu doldurur. Bu jetonun değeri iş ortağına özeldir ve sonraki sayfa URL'sini oluşturmak için kullanılır. nextTokenParam alanı, son sayfa için doldurulmamalıdır. Son sayfada nextTokenParam alanı olmasa da metadata.pagination nesnesinin her zaman doldurulması gerektiğini (şemada zorunlu olduğu için) lütfen unutmayın. Ayrıca, totalCount tüm sayfalardaki toplam hizmet sağlayıcı sayısını (veya yorum feed'i söz konusu olduğunda reviewItems) gösterir.

Örneğin, bir iş ortağının tam anlık görüntüde 200 sağlayıcısı varsa. Google, http://www.partners.com/feeds/{version}/profile&maxresults=100 URL'siyle feed'leri aktarmaya başladığında ilk sayfada aşağıdaki metaData ile ilk 100 iş ortağı sağlayıcı döndürülmelidir:

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

Google, nextTokenParam: "yre7yiesar" değerini ayrıştırır ve şu URL ile ikinci aktarımı başlatır: http:partners.com/feeds/{version}/profile&nextpagetoken=yre7yiesar&maxresults=100

İkinci sayfa, son 100 sağlayıcıyı döndürmelidir. İkinci sayfanın aynı zamanda son sayfa olduğu göz önüne alındığında, sayfalara ayırma işleminin sonunu belirtmek için nextTokenParam doldurulmaz (aşağıdaki metaData örneğinde gösterilmiştir).

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

Tüm sayfalar getirildikten sonra serviceProviders nesnelerinin toplam sayısının (tüm sayfalarda) ilk sayfa getirme işleminde belirtilen totalCount sayısına eşit olması gerektiğini unutmayın.