खास जानकारी

पेज पर नंबर डालना

LSA, पेज नंबर के हिसाब से डेटा दिखाने की सुविधा के साथ काम करता है. इससे कई पेजों से डेटा फ़ेच (पुल) करने के अनुरोधों को पूरा किया जा सकता है. Google, दिए गए पार्टनर एंडपॉइंट को maxresults पैरामीटर के साथ पुल करेगा, ताकि JSON रिस्पॉन्स में दिखाए गए serviceProviders की ज़्यादा से ज़्यादा संख्या को सीमित किया जा सके. पार्टनर, JSON रिस्पॉन्स में मौजूद metadata.pagination.nextTokenParam फ़ील्ड में पेज नंबर के हिसाब से टोकन भरेंगे. इस टोकन की वैल्यू, पार्टनर के हिसाब से होती है. इसका इस्तेमाल, अगले पेज का यूआरएल बनाने के लिए किया जाता है. आखिरी पेज के लिए, nextTokenParam फ़ील्ड में वैल्यू नहीं होनी चाहिए. कृपया ध्यान दें कि metadata.pagination ऑब्जेक्ट हमेशा भरा होना चाहिए, क्योंकि यह स्कीमा में ज़रूरी है. भले ही, आखिरी पेज में metadata.pagination फ़ील्ड न हो.nextTokenParam इसके अलावा, totalCount से सभी पेजों पर सेवा देने वाली कंपनियों की कुल संख्या का पता चलता है. अगर समीक्षाओं का फ़ीड है, तो reviewItems से सेवा देने वाली कंपनियों की कुल संख्या का पता चलता है.

उदाहरण के लिए, अगर किसी पार्टनर के पास स्नैपशॉट में 200 डॉक्टर हैं. जब Google, यूआरएल http://www.partners.com/feeds/{version}/profile&maxresults=100 के साथ फ़ीड ट्रांसफ़र शुरू करता है, तो पहले पेज पर पार्टनर के तौर पर सेवाएं देने वाली पहली 100 कंपनियों की जानकारी दिखनी चाहिए. साथ ही, इनमें ये metaData शामिल होने चाहिए:

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

Google, nextTokenParam: "yre7yiesar" को पार्स करेगा और इस यूआरएल के साथ दूसरा ट्रांसफ़र शुरू करेगा: http:partners.com/feeds/{version}/profile&nextpagetoken=yre7yiesar&maxresults=100

दूसरे पेज पर, पिछले 100 प्रोवाइडर की जानकारी दिखनी चाहिए. दूसरा पेज ही आखिरी पेज है. इसलिए, nextTokenParam फ़ील्ड में कोई वैल्यू नहीं भरी जाएगी (metaData का उदाहरण नीचे दिया गया है). इससे पता चलता है कि पेज नंबरिंग खत्म हो गई है.

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

ध्यान दें कि सभी पेजों को फ़ेच करने के बाद, सभी पेजों पर मौजूद serviceProviders ऑब्जेक्ट की कुल संख्या, पहले पेज को फ़ेच करने पर दिखने वाली totalCount संख्या के बराबर होनी चाहिए.