TokenPagination
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
هنگامی که صفحه‌بندی نشانه فعال است، اطلاعات صفحه‌بندی توسط یک عملیات فهرست برگردانده می‌شود.
لیست عملیاتی که از صفحه بندی پشتیبانی می کند تنها یک "صفحه" از نتایج را برمی گرداند. این پیام بافر پروتکل صفحه ای را که بازگردانده شده است توصیف می کند.
هنگام استفاده از صفحه بندی توکن، مشتریان باید از نشانه بعدی/قبلی برای دریافت صفحه دیگری از نتیجه استفاده کنند. وجود یا عدم وجود نشانه بعدی/قبلی نشان می دهد که آیا صفحه بعدی/قبلی در دسترس است یا خیر و وسیله ای برای دسترسی به این صفحه فراهم می کند. ListRequest.page_token باید روی nextPageToken یا previousPageToken برای دسترسی به صفحه دیگری تنظیم شود.
| نمایندگی JSON |
|---|
{
"nextPageToken": string,
"previousPageToken": string
} |
| فیلدها |
|---|
nextPageToken | string توکن‌هایی که باید به فیلد فهرست استاندارد «pageToken» منتقل شوند. هر زمان که در دسترس باشد، توکن ها به دستکاری startIndex ترجیح داده می شوند. |
previousPageToken | string |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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` |"]]
