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