TokenPagination
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Paginierungsinformationen, die von einem List-Vorgang zurückgegeben werden, wenn die Token-Paginierung aktiviert ist.
Beim Auflisten von Vorgängen, die Paging unterstützen, wird nur eine einzige „Seite“ zurückgegeben der Ergebnisse. Diese Protokollpuffernachricht beschreibt die zurückgegebene Seite.
Bei der Token-Paginierung sollten Clients das nächste/vorherige Token verwenden, um eine weitere Seite des Ergebnisses abzurufen. Das Vorhandensein oder Fehlen eines nächsten/vorherigen Tokens gibt an, ob eine nächste/vorherige Seite verfügbar ist, und bietet eine Möglichkeit für den Zugriff auf diese Seite. „ListRequest.page_token“ sollte für den Zugriff auf eine andere Seite entweder auf „nextPageToken“ oder „previousPageToken“ festgelegt werden.
| JSON-Darstellung |
{
"nextPageToken": string,
"previousPageToken": string
} |
| Felder |
nextPageToken |
string
Tokens, die an das Standard-Listenfeld "pageToken" übergeben werden sollen. Sofern verfügbar, werden Tokens gegenüber der Bearbeitung von „startIndex“ bevorzugt.
|
previousPageToken |
string
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\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` |"]]
