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

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