Method: monetization.subscriptions.basePlans.offers.create
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Tworzy nową ofertę subskrypcji. Oferty subskrypcji mogą zawierać tylko automatycznie odnawiane abonamenty podstawowe. Stan oferty będzie miał wartość WERSJA ROBOCZA, dopóki nie zostanie aktywowana.
Żądanie HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
packageName |
string
To pole jest wymagane. Aplikacja nadrzędna (nazwa pakietu), dla której należy utworzyć ofertę. Musi być taka sama jak wartość pola packageName w zasobie subskrypcji.
|
productId |
string
To pole jest wymagane. Subskrypcja nadrzędna (identyfikator), dla której ma zostać utworzona oferta. Musi być taka sama jak pole productId w zasobie SubscriptionOffer.
|
basePlanId |
string
To pole jest wymagane. Nadrzędny abonament podstawowy (identyfikator), dla którego ma zostać utworzona oferta. Musi być taka sama jak pole basePlanId w zasobie SubscriptionOffer.
|
Parametry zapytania
| Parametry |
offerId |
string
To pole jest wymagane. Identyfikator oferty. Wymagania dotyczące tego formatu znajdziesz w dokumentacji pola offerId w zasobie SubscriptionOffer.
|
regionsVersion |
object (RegionsVersion)
To pole jest wymagane. Wersja dostępnych regionów używanych w przypadku oferty subscriptionOffer.
|
Treść żądania
Treść żądania zawiera wystąpienie elementu SubscriptionOffer.
Treść odpowiedzi
Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję SubscriptionOffer.
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/androidpublisher
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[null,null,["Ostatnia aktualizacja: 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`"]]
