TokenPagination
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Thông tin phân trang do thao tác Danh sách trả về khi tính năng phân trang mã thông báo được bật.
Các thao tác liệt kê có hỗ trợ phân trang chỉ trả về một "trang" kết quả. Thông báo vùng đệm giao thức này mô tả trang đã được trả về.
Khi sử dụng tính năng phân trang bằng mã thông báo, ứng dụng khách nên sử dụng mã thông báo tiếp theo/trước để nhận một trang kết quả khác. Sự hiện diện hay không có mã thông báo tiếp theo/trước cho biết có trang tiếp theo/trước hay không và cung cấp cách truy cập trang này. Bạn phải đặt ListRequest.page_token thành nextPageToken hoặc previousPageToken để truy cập vào một trang khác.
| Biểu diễn dưới dạng JSON |
{
"nextPageToken": string,
"previousPageToken": string
} |
| Trường |
nextPageToken |
string
Các mã thông báo cần truyền đến trường danh sách chuẩn "pageToken". Bất cứ khi nào có sẵn, mã thông báo sẽ được ưu tiên hơn việc thao túng startIndex.
|
previousPageToken |
string
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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` |"]]
