Method: inappproducts.list
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.
Liệt kê tất cả sản phẩm trong ứng dụng – cả sản phẩm được quản lý và gói thuê bao.
Nếu một ứng dụng có nhiều sản phẩm trong ứng dụng, thì phản hồi có thể được phân trang. Trong trường hợp này, trường phản hồi tokenPagination.nextPageToken sẽ được đặt và phương thức gọi phải cung cấp giá trị của trường đó dưới dạng tham số yêu cầu token để truy xuất trang tiếp theo.
Bạn không nên sử dụng phương thức này để truy xuất các gói thuê bao nữa. Hãy xem bài viết này để biết thêm thông tin.
Yêu cầu HTTP
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/inappproducts
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Tham số |
packageName |
string
Tên gói của ứng dụng.
|
Tham số truy vấn
| Tham số |
token |
string
Mã thông báo phân trang. Nếu trống, danh sách sẽ bắt đầu từ sản phẩm đầu tiên.
|
startIndex
(deprecated) |
integer (uint32 format)
Không được dùng nữa và bị bỏ qua. Đặt tham số token để truy xuất trang tiếp theo.
|
maxResults
(deprecated) |
integer (uint32 format)
Không được dùng nữa và bị bỏ qua. Kích thước trang là do máy chủ xác định.
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Câu trả lời liệt kê tất cả sản phẩm trong ứng dụng.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
| Trường |
kind |
string
Loại phản hồi này ("androidpublisher#inappproductsListResponse").
|
inappproduct[] |
object (InAppProduct)
Tất cả sản phẩm trong ứng dụng.
|
tokenPagination |
object (TokenPagination)
Mã thông báo phân trang, để xử lý một số sản phẩm dài hơn một trang.
|
pageInfo
(deprecated) |
object (PageInfo)
Không được dùng nữa và chưa đặt.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/androidpublisher
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\u003eLists all in-app products for an application, including both managed products and subscriptions, with pagination for large datasets.\u003c/p\u003e\n"],["\u003cp\u003eIt is recommended to utilize the \u003ccode\u003etoken\u003c/code\u003e parameter for pagination instead of the deprecated \u003ccode\u003estartIndex\u003c/code\u003e and \u003ccode\u003emaxResults\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eThis method should no longer be used to retrieve subscriptions, and developers should refer to the provided article for alternative methods.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e scope for access.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides details about the in-app products, pagination information, and overall response structure in JSON format.\u003c/p\u003e\n"]]],["This API retrieves a list of in-app products (managed products and subscriptions) via a `GET` request to `https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/inappproducts`. Specify the app's package name in the path. Pagination is handled through the `token` query parameter; if the response includes `tokenPagination.nextPageToken`, use its value to retrieve the next page. The request body must be empty, and authorization requires the `androidpublisher` OAuth scope. Subscriptions should not be retrieved with this method anymore.\n"],null,["# Method: inappproducts.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.InappproductsListResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all in-app products - both managed products and subscriptions.\n\nIf an app has a large number of in-app products, the response may be paginated. In this case the response field `tokenPagination.nextPageToken` will be set and the caller should provide its value as a `token` request parameter to retrieve the next page.\n\nThis method should no longer be used to retrieve subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.\n\n### HTTP request\n\n`GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/inappproducts`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|-----------------------------------|\n| `packageName` | `string` Package name of the app. |\n\n### Query parameters\n\n| Parameters ||\n|-------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `token` | `string` Pagination token. If empty, list starts at the first product. |\n| `startIndex` **(deprecated)** | `integer (`[uint32](https://developers.google.com/discovery/v1/type-format)` format)` Deprecated and ignored. Set the `token` parameter to retrieve the next page. |\n| `maxResults` **(deprecated)** | `integer (`[uint32](https://developers.google.com/discovery/v1/type-format)` format)` Deprecated and ignored. The page size is determined by the server. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse listing all in-app products.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"inappproduct\": [ { object (/android-publisher/api-ref/rest/v3/inappproducts#InAppProduct) } ], \"tokenPagination\": { object (/android-publisher/api-ref/rest/v3/TokenPagination) }, \"pageInfo\": { object (/android-publisher/api-ref/rest/v3/PageInfo) } } ``` |\n\n| Fields ||\n|-----------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` The kind of this response (\"androidpublisher#inappproductsListResponse\"). |\n| `inappproduct[]` | `object (`[InAppProduct](/android-publisher/api-ref/rest/v3/inappproducts#InAppProduct)`)` All in-app products. |\n| `tokenPagination` | `object (`[TokenPagination](/android-publisher/api-ref/rest/v3/TokenPagination)`)` Pagination token, to handle a number of products that is over one page. |\n| `pageInfo` **(deprecated)** | `object (`[PageInfo](/android-publisher/api-ref/rest/v3/PageInfo)`)` | This item is deprecated! Deprecated and unset. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
