TokenPagination
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
启用令牌分页后,List 操作返回的分页信息。
支持分页的操作列表仅返回一个“页面”结果。此协议缓冲区消息描述了返回的页面。
使用令牌分页时,客户端应使用下一个/上一个令牌来获取另一页结果。是否有下一个/上一个令牌表示下一个/上一个页面是否可用,并提供访问此页面的方法。要访问其他页面,应将 ListRequest.page_token 设为 nextPageToken 或 previousPageToken。
JSON 表示法 |
{
"nextPageToken": string,
"previousPageToken": string
} |
字段 |
nextPageToken |
string
要传递给标准列表字段“pageToken”的令牌。只要可用,令牌就会优于处理 startIndex。
|
previousPageToken |
string
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):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` |"]]