Method: monetization.subscriptions.basePlans.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 thuê bao.
Yêu cầu HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchGet
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Tham số |
packageName |
string
Bắt buộc. Ứng dụng mẹ (tên gói) mà bạn cần tạo hoặc cập nhật gói thuê bao. Phải bằng trường packageName trên tất cả yêu cầu.
|
productId |
string
Bắt buộc. Mã sản phẩm của gói thuê bao chính nếu tất cả các ưu đãi được cập nhật đều thuộc về cùng một gói thuê bao. Nếu yêu cầu này áp dụng cho nhiều gói thuê bao, hãy đặt trường này thành "-". Phải đặt.
|
basePlanId |
string
Bắt buộc. Gói cơ bản (mã) chính mà bạn cần đọc ưu đãi. Có thể được chỉ định là '-' để đọc ưu đãi của nhiều gói cơ bản.
|
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 (GetSubscriptionOfferRequest)
Bắt buộc. Danh sách các yêu cầu cập nhật gồm tối đa 100 phần tử. Tất cả các yêu cầu phải cập nhật các gói thuê bao khác nhau.
|
Nội dung phản hồi
Thông báo phản hồi cho điểm cuối Offerwall.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:
| Biểu diễn dưới dạng JSON |
{
"subscriptionOffers": [
{
object (SubscriptionOffer)
}
]
} |
| Trường |
subscriptionOffers[] |
object (SubscriptionOffer)
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/androidpublisher
GetSubscriptionOfferRequest
Yêu cầu tin nhắn đối với offer.get.
| Biểu diễn dưới dạng JSON |
{
"packageName": string,
"productId": string,
"basePlanId": string,
"offerId": string
} |
| Trường |
packageName |
string
Bắt buộc. Ứng dụng mẹ (tên gói) của ưu đãi muốn nhận.
|
productId |
string
Bắt buộc. Gói thuê bao chính (Mã nhận dạng) của ưu đãi sẽ nhận được.
|
basePlanId |
string
Bắt buộc. Gói cơ bản chính (Mã) của ưu đãi sẽ được nhận.
|
offerId |
string
Bắt buộc. Mã ưu đãi duy nhất của ưu đãi nhận được.
|
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\u003eReads one or more subscription offers for a specified app, product, and base plan using a POST request.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing a list of \u003ccode\u003eGetSubscriptionOfferRequest\u003c/code\u003e objects, each specifying the package name, product ID, base plan ID, and offer ID.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of \u003ccode\u003eSubscriptionOffer\u003c/code\u003e objects containing details about the retrieved subscription offers.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eSupports batch retrieval of up to 100 offers, but all requests must update different subscriptions.\u003c/p\u003e\n"]]],["This document outlines the process for retrieving subscription offers via a batch request. It uses a `POST` request to a specified URL, including `packageName`, `productId`, and `basePlanId` as path parameters. The request body requires a JSON array of `GetSubscriptionOfferRequest` objects, each needing `packageName`, `productId`, `basePlanId`, and `offerId`. The response contains an array of `SubscriptionOffer` objects, presented in a JSON format. The `https://www.googleapis.com/auth/androidpublisher` authorization scope is required.\n"],null,["# Method: monetization.subscriptions.basePlans.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.BatchGetSubscriptionOffersResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [GetSubscriptionOfferRequest](#GetSubscriptionOfferRequest)\n - [JSON representation](#GetSubscriptionOfferRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nReads one or more subscription offers.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/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) for which the subscriptions should be created or updated. Must be equal to the packageName field on all the requests. |\n| `productId` | `string` Required. The product ID of the parent subscription, if all updated offers belong to the same subscription. If this request spans multiple subscriptions, set this field to \"-\". Must be set. |\n| `basePlanId` | `string` Required. The parent base plan (ID) for which the offers should be read. May be specified as '-' to read offers from multiple base plans. |\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.subscriptions.basePlans.offers/batchGet#GetSubscriptionOfferRequest) } ] } ``` |\n\n| Fields ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (`[GetSubscriptionOfferRequest](/android-publisher/api-ref/rest/v3/monetization.subscriptions.basePlans.offers/batchGet#GetSubscriptionOfferRequest)`)` Required. A list of update requests of up to 100 elements. All requests must update different subscriptions. |\n\n### Response body\n\nResponse message for offers.batchGet endpoint.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"subscriptionOffers\": [ { object (/android-publisher/api-ref/rest/v3/monetization.subscriptions.basePlans.offers#SubscriptionOffer) } ] } ``` |\n\n| Fields ||\n|------------------------|------------------------------------------------------------------------------------------------------------------------------------|\n| `subscriptionOffers[]` | `object (`[SubscriptionOffer](/android-publisher/api-ref/rest/v3/monetization.subscriptions.basePlans.offers#SubscriptionOffer)`)` |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`\n\nGetSubscriptionOfferRequest\n---------------------------\n\nRequest message for offers.get.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------|\n| ``` { \"packageName\": string, \"productId\": string, \"basePlanId\": 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 subscription (ID) of the offer to get. |\n| `basePlanId` | `string` Required. The parent base plan (ID) of the offer to get. |\n| `offerId` | `string` Required. The unique offer ID of the offer to get. |"]]
