قوائم الموارد المقسّمة إلى صفحات

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