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