Method: monetization.onetimeproducts.purchaseOptions.offers.batchGet
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.
Đọc một hoặc nhiều ưu đãi sản phẩm tính phí một lần.
Yêu cầu HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchGet
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số |
packageName |
string
Bắt buộc. Ứng dụng mẹ (tên gói) của các sản phẩm được cập nhật. Phải bằng với trường packageName trên tất cả tài nguyên OneTimeProductOffer được cập nhật.
|
productId |
string
Bắt buộc. Mã sản phẩm của sản phẩm tính phí một lần chính, nếu tất cả các sản phẩm được cập nhật đều thuộc cùng một sản phẩm. Nếu yêu cầu này bao gồm nhiều sản phẩm dùng một lần, hãy đặt trường này thành "-".
|
purchaseOptionId |
string
Bắt buộc. Lựa chọn mua tổng/chính (mã nhận dạng) mà bạn cần cập nhật ưu đãi. Bạn có thể chỉ định là "-" để cập nhật các sản phẩm từ nhiều lựa chọn mua.
|
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Trường |
requests[] |
object (GetOneTimeProductOfferRequest )
Bắt buộc. Danh sách các yêu cầu nhận tối đa 100 phần tử. Tất cả các yêu cầu phải truy xuất các sản phẩm khác nhau.
|
Nội dung phản hồi
Thông báo phản hồi cho điểm cuối offers.batchGet.
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 |
oneTimeProductOffers[] |
object (OneTimeProductOffer )
Danh sách các sản phẩm tính phí một lần được cập nhật, theo cùng thứ tự như yêu cầu.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/androidpublisher
GetOneTimeProductOfferRequest
Thông báo yêu cầu cho GetOneTimeProductOffers.
Biểu diễn dưới dạng JSON |
{
"packageName": string,
"productId": string,
"purchaseOptionId": string,
"offerId": string
} |
Trường |
packageName |
string
Bắt buộc. Ứng dụng mẹ (tên gói) của ưu đãi cần nhận.
|
productId |
string
Bắt buộc. Sản phẩm tính phí một lần gốc (mã nhận dạng) của ưu đãi cần nhận.
|
purchaseOptionId |
string
Bắt buộc. Lựa chọn mua gốc (mã nhận dạng) của ưu đãi cần nhận.
|
offerId |
string
Bắt buộc. Mã ưu đãi duy nhất của ưu đãi cần nhận.
|
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."],[],[],null,["# Method: monetization.onetimeproducts.purchaseOptions.offers.batchGet\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.BatchGetOneTimeProductOffersResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [GetOneTimeProductOfferRequest](#GetOneTimeProductOfferRequest)\n - [JSON representation](#GetOneTimeProductOfferRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nReads one or more one-time product offers.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchGet`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `packageName` | `string` Required. The parent app (package name) of the updated offers. Must be equal to the packageName field on all the updated OneTimeProductOffer resources. |\n| `productId` | `string` Required. The product ID of the parent one-time product, if all updated offers belong to the same product. If this request spans multiple one-time products, set this field to \"-\". |\n| `purchaseOptionId` | `string` Required. The parent purchase option (ID) for which the offers should be updated. May be specified as '-' to update offers from multiple purchase options. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"requests\": [ { object (/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions.offers/batchGet#GetOneTimeProductOfferRequest) } ] } ``` |\n\n| Fields ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (`[GetOneTimeProductOfferRequest](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions.offers/batchGet#GetOneTimeProductOfferRequest)`)` Required. A list of get requests of up to 100 elements. All requests must retrieve different offers. |\n\n### Response body\n\nResponse message for the offers.batchGet endpoint.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"oneTimeProductOffers\": [ { object (/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions.offers#OneTimeProductOffer) } ] } ``` |\n\n| Fields ||\n|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `oneTimeProductOffers[]` | `object (`[OneTimeProductOffer](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions.offers#OneTimeProductOffer)`)` The list of updated one-time product offers, in the same order as the request. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`\n\nGetOneTimeProductOfferRequest\n-----------------------------\n\nRequest message for GetOneTimeProductOffers.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------|\n| ``` { \"packageName\": string, \"productId\": string, \"purchaseOptionId\": string, \"offerId\": string } ``` |\n\n| Fields ||\n|--------------------|--------------------------------------------------------------------------|\n| `packageName` | `string` Required. The parent app (package name) of the offer to get. |\n| `productId` | `string` Required. The parent one-time product (ID) of the offer to get. |\n| `purchaseOptionId` | `string` Required. The parent purchase option (ID) of the offer to get. |\n| `offerId` | `string` Required. The unique offer ID of the offer to get. |"]]