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

يمكنك التحكّم في الحدّ الأقصى لعدد الموارد التي يعرضها الخادم في الردّ على طلب قائمة من خلال ضبط الحقل maxResults. علاوةً على ذلك، هناك حدّ أقصى ثابت لعدد الإدخالات المسترجَعة التي لا يتجاوزها الخادم أبدًا، وذلك بالنسبة إلى بعض المجموعات (مثل الأحداث). إذا تجاوز العدد الإجمالي للأحداث هذا الحدّ الأقصى، يعرض الخادم صفحة واحدة من النتائج.

يُرجى العِلم أنّ maxResults لا يضمن عدد النتائج في صفحة واحدة. يشير الحقل nextPageToken غير الفارغ في الردّ إلى نتائج غير مكتملة. لاسترجاع الصفحة التالية، كرِّر الطلب السابق وأضِف مَعلمة pageToken بقيمة nextPageToken من الصفحة السابقة. توفّر كل صفحة لاحقة nextPageToken جديدًا إلى أن يتضمّن الردّ جميع النتائج.

على سبيل المثال، يطلب طلب البحث التالي الصفحة الأولى:

GET /calendars/primary/events?maxResults=10&singleEvents=true

يتضمّن الردّ nextPageToken:

{
  "nextPageToken": "CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA"
}

يأخذ طلب البحث اللاحق القيمة من nextPageToken ويرسلها كقيمة لـ pageToken:

GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA