TokenPagination
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
معلومات التقسيم على صفحات التي تعرضها عملية "القائمة" عند تفعيل تقسيم الرمز على صفحات للرمز المميّز
إدراج العمليات التي تتيح التقسيم إلى صفحات تُرجع "صفحة" واحدة فقط من النتائج. تصف رسالة المخزن المؤقت للبروتوكول هذه الصفحة التي تم عرضها.
عند استخدام عملية تقسيم الرموز المميّزة على صفحات، يجب أن يستخدم العملاء الرمز المميّز التالي/السابق للحصول على صفحة أخرى للنتائج. يشير وجود أو عدم وجود الرمز المميز التالي/السابق إلى ما إذا كانت الصفحة التالية/السابقة متاحة ويوفر طريقة للوصول إلى هذه الصفحة. يجب ضبط ListRequest.page_token على nextPageToken أو السابقPageToken للوصول إلى صفحة أخرى.
| تمثيل JSON |
{
"nextPageToken": string,
"previousPageToken": string
} |
| الحقول |
nextPageToken |
string
الرموز المميزة لتمريرها إلى حقل القائمة العادية "pageToken". عندما يكون ذلك متاحًا، يُفضل استخدام الرموز المميزة بدلاً من معالجة startIndex.
|
previousPageToken |
string
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis document explains the structure of pagination information returned for list operations that support paging when token pagination is enabled.\u003c/p\u003e\n"],["\u003cp\u003eClients should utilize the \u003ccode\u003enextPageToken\u003c/code\u003e or \u003ccode\u003epreviousPageToken\u003c/code\u003e to navigate between pages of results.\u003c/p\u003e\n"],["\u003cp\u003eThe presence or absence of these tokens indicates the availability of additional pages.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON representation of this pagination information includes \u003ccode\u003enextPageToken\u003c/code\u003e and \u003ccode\u003epreviousPageToken\u003c/code\u003e fields as strings.\u003c/p\u003e\n"]]],["List operations with pagination return one page of results. `nextPageToken` and `previousPageToken` are provided as strings to access subsequent or prior pages. Clients should set `ListRequest.page_token` to one of these tokens for navigation. The presence of these tokens indicates if a respective page is available. Tokens are favored over manipulating `startIndex` for accessing pages. JSON representation uses these string values.\n"],null,["# TokenPagination\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nPagination information returned by a List operation when token pagination is enabled.\n\nList operations that supports paging return only one \"page\" of results. This protocol buffer message describes the page that has been returned.\n\nWhen using token pagination, clients should use the next/previous token to get another page of the result. The presence or absence of next/previous token indicates whether a next/previous page is available and provides a mean of accessing this page. ListRequest.page_token should be set to either nextPageToken or previousPageToken to access another page.\n\n| JSON representation |\n|------------------------------------------------------------------|\n| ``` { \"nextPageToken\": string, \"previousPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| `nextPageToken` | `string` Tokens to pass to the standard list field 'pageToken'. Whenever available, tokens are preferred over manipulating startIndex. |\n| `previousPageToken` | `string` |"]]
