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

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