تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك التحكّم في الحد الأقصى لعدد الموارد التي يعرضها الخادم في الرد على طلب قائمة من خلال ضبط الحقل 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
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,[]]
