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

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