Method: monetization.subscriptions.basePlans.offers.create
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.
Tạo một ưu đãi mới cho gói thuê bao. Chỉ những gói cơ bản tự động gia hạn mới có thể có ưu đãi trong gói thuê bao. Trạng thái ưu đãi sẽ là BẢN NHÁP cho đến khi được kích hoạt.
Yêu cầu HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Các tham số |
packageName |
string
Bắt buộc. Ứng dụng gốc (tên gói) mà bạn nên tạo ưu đãi. Phải bằng với trường packageName trên tài nguyên Gói thuê bao.
|
productId |
string
Bắt buộc. Gói thuê bao chính (mã nhận dạng) mà bạn sẽ tạo ưu đãi. Phải bằng với trường productId trên tài nguyên SubscriptionOffer.
|
basePlanId |
string
Bắt buộc. Gói cơ bản (mã nhận dạng) gốc mà bạn sẽ tạo ưu đãi. Phải bằng trường basePlanId trên tài nguyên SubscriptionOffer.
|
Tham số truy vấn
| Các tham số |
offerId |
string
Bắt buộc. Mã nhận dạng để sử dụng cho ưu đãi. Để biết các yêu cầu đối với định dạng này, hãy xem tài liệu về trường offerId trên tài nguyên SubscriptionOffer.
|
regionsVersion |
object (RegionsVersion)
Bắt buộc. Phiên bản của các khu vực hiện có đang được dùng cho gói thuê baoƯu đãi.
|
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của SubscriptionOffer.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một thực thể mới được tạo của SubscriptionOffer.
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\u003eCreates a new subscription offer for auto-renewing base plans, initially in DRAFT state until activated.\u003c/p\u003e\n"],["\u003cp\u003eUses an HTTP POST request to \u003ccode\u003ehttps://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers\u003c/code\u003e with specified path and query parameters.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing a \u003ccode\u003eSubscriptionOffer\u003c/code\u003e object in the request body, detailing the offer's specifics.\u003c/p\u003e\n"],["\u003cp\u003eUpon success, the response body returns the newly created \u003ccode\u003eSubscriptionOffer\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document details how to create a new subscription offer for auto-renewing base plans. The `POST` request is sent to a specific URL with `packageName`, `productId`, and `basePlanId` as required path parameters. The `offerId` and `regionsVersion` are required query parameters. The request body must contain `SubscriptionOffer` data, and a successful response returns the newly created `SubscriptionOffer`. Authorization requires the `https://www.googleapis.com/auth/androidpublisher` OAuth scope.\n"],null,["# Method: monetization.subscriptions.basePlans.offers.create\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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a new subscription offer. Only auto-renewing base plans can have subscription offers. The offer state will be DRAFT until it is activated.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers`\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 offer should be created. Must be equal to the packageName field on the Subscription resource. |\n| `productId` | `string` Required. The parent subscription (ID) for which the offer should be created. Must be equal to the productId field on the SubscriptionOffer resource. |\n| `basePlanId` | `string` Required. The parent base plan (ID) for which the offer should be created. Must be equal to the basePlanId field on the SubscriptionOffer resource. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `offerId` | `string` Required. The ID to use for the offer. For the requirements on this format, see the documentation of the offerId field on the SubscriptionOffer resource. |\n| `regionsVersion` | `object (`[RegionsVersion](/android-publisher/api-ref/rest/v3/RegionsVersion)`)` Required. The version of the available regions being used for the subscriptionOffer. |\n\n### Request body\n\nThe request body contains an instance of [SubscriptionOffer](/android-publisher/api-ref/rest/v3/monetization.subscriptions.basePlans.offers#SubscriptionOffer).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [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`"]]
