قوائم الموارد المقسّمة إلى صفحات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك التحكّم في الحدّ الأقصى لعدد الموارد التي يعرضها الخادم في الردّ على طلب قائمة من خلال ضبط الحقل 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
تاريخ التعديل الأخير: 2026-09-11 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2026-09-11 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]
