تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك التحكّم في الحد الأقصى لعدد الموارد التي يعرضها الخادم في
الردّ على طلب قائمة من خلال ضبط الحقل 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
تاريخ التعديل الأخير: 2024-12-21 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2024-12-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Control the maximum number of resources returned in a list request by setting the `maxResults` field, with some collections having hard limits on retrievable entries."],["Detect incomplete results by checking for a non-empty `nextPageToken` field, which indicates the presence of additional pages."],["Retrieve the next page of results by performing the same request and appending a `pageToken` field with the `nextPageToken` value from the previous page."],["The server provides new `nextPageToken` values on subsequent pages until all results are retrieved, enabling complete data retrieval through pagination."]]],[]]
