يمكنك التحكّم في الحد الأقصى لعدد الموارد التي يعرضها الخادم في الاستجابة لطلب قائمة من خلال ضبط الحقل 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