maxResults
फ़ील्ड सेट करके, यह तय किया जा सकता है कि सूची के अनुरोध के जवाब में, सर्वर ज़्यादा से ज़्यादा कितने रिसॉर्स दिखाए. इसके अलावा,
कुछ कलेक्शन (जैसे कि इवेंट) के लिए, सर्वर को फिर से पाने की संख्या की
सीमित संख्या होती है. अगर इवेंट की कुल संख्या इस सीमा से ज़्यादा हो जाती है, तो सर्वर, नतीजों का एक पेज दिखाता है.
याद रखें कि maxResults
एक पेज पर नतीजों की संख्या की गारंटी नहीं देता है.
अधूरे नतीजों की पहचान, नतीजे में किसी खाली nextPageToken
फ़ील्ड से की जा सकती है. अगले पेज को वापस पाने के लिए, पहले जैसा ही अनुरोध करें. साथ ही, पिछले पेज के pageToken
फ़ील्ड को nextPageToken
वैल्यू के साथ जोड़ें. इन पेजों पर नया 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