قوائم الموارد المقسّمة إلى صفحات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك التحكّم في الحد الأقصى لعدد الموارد التي يعرضها الخادم في الرد على طلب قائمة من خلال ضبط الحقل 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
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Page through lists of resources\n\nYou can control the maximum number of resources the server returns in the\nresponse to a list request by setting the `maxResults` field. Furthermore,\nfor some collections (such as Events) there is a hard limit on the number of\nretrieved entries that the server will never exceed. If the total number of\nevents exceeds this maximum, the server returns one page of results.\n\nRemember that `maxResults` does not guarantee the number of results on one page.\nIncomplete results can be detected by a non-empty `nextPageToken` field in\nthe result. In order to retrieve the next page, perform the exact same request\nas previously and append a `pageToken` field with the value of\n`nextPageToken` from the previous page. A new `nextPageToken` is provided\non the following pages until all the results are retrieved.\n\nFor example, here is a query followed by the query for retrieving the\nnext page of results in a paginated list: \n\n GET /calendars/primary/events?maxResults=10&singleEvents=true\n\n //Result contains\n\n \"nextPageToken\":\"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA\",\n\nThe subsequent query takes the value from `nextPageToken` and\nsubmits it as the value for `pageToken`: \n\n GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA"]]
