संसाधनों की सूचियों के ज़रिए पेज

आप 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