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