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

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