सूची के अनुरोध के रिस्पॉन्स में, सर्वर से मिलने वाले रिसॉर्स की ज़्यादा से ज़्यादा संख्या को कंट्रोल किया जा सकता है. इसके लिए, maxResults
फ़ील्ड को सेट करें. इसके अलावा,
कुछ कलेक्शन (जैसे कि इवेंट) के लिए, फिर से हासिल की गई एंट्री की
एक हार्ड सीमा होती है जिसे सर्वर कभी भी पार नहीं करेगा. अगर इवेंट की कुल संख्या इससे ज़्यादा हो जाती है, तो सर्वर नतीजों का एक पेज दिखाता है.
याद रखें कि maxResults
किसी एक पेज पर नतीजों की संख्या की गारंटी नहीं देता.
अधूरे नतीजों को नतीजे में एक खाली nextPageToken
फ़ील्ड से पहचाना जा सकता है. अगले पेज को वापस पाने के लिए, वही अनुरोध करें जो आपने पहले किया था. साथ ही, पिछले पेज पर मौजूद nextPageToken
वैल्यू के साथ pageToken
फ़ील्ड जोड़ें. अगले पेजों पर एक नया nextPageToken
तब तक दिखाया जाता है, जब तक सभी नतीजे वापस नहीं मिल जाते.
उदाहरण के लिए, यहां एक क्वेरी है जिसके बाद पेज नंबर वाली सूची में नतीजों के अगले पेज को वापस लाने के लिए क्वेरी की जाती है:
GET /calendars/primary/events?maxResults=10&singleEvents=true
//Result contains
"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",
इसके बाद की क्वेरी nextPageToken
से वैल्यू लेकर उसे pageToken
के लिए वैल्यू के तौर पर सबमिट करती है:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA