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