Method: monetization.subscriptions.create
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Tworzy nową subskrypcję. Nowo dodane abonamenty podstawowe pozostaną w wersji roboczej, dopóki nie zostaną aktywowane.
Żądanie HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions
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ć subskrypcję. Musi być taka sama jak wartość pola packageName w zasobie subskrypcji.
|
Parametry zapytania
| Parametry |
productId |
string
To pole jest wymagane. Identyfikator subskrypcji. Wymagania dotyczące tego formatu znajdziesz w dokumentacji pola productId w zasobie subskrypcji.
|
regionsVersion |
object (RegionsVersion)
To pole jest wymagane. Wersja dostępnych regionów używanych w subskrypcji.
|
Treść żądania
Treść żądania zawiera wystąpienie elementu Subscription.
Treść odpowiedzi
Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję Subscription.
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 for a specified Android app package.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing the package name, subscription ID, and regions version in the request.\u003c/p\u003e\n"],["\u003cp\u003eThe newly created subscription will initially be in draft state and needs to be activated.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain a \u003ccode\u003eSubscription\u003c/code\u003e resource, and a successful response will return the newly created \u003ccode\u003eSubscription\u003c/code\u003e instance.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This document details how to create a new subscription using the Android Publisher API. A `POST` request is sent to a specified URL, including the `packageName` in the path. The request requires `productId` and `regionsVersion` as query parameters. The request body contains the `Subscription` to be created. A successful response returns a newly created `Subscription`. The process uses gRPC Transcoding and requires the `androidpublisher` OAuth scope. Newly added base plans are in draft until activated.\n"],null,["# Method: monetization.subscriptions.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. Newly added base plans will remain in draft state until activated.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions`\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 subscription should be created. Must be equal to the packageName field on the Subscription resource. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `productId` | `string` Required. The ID to use for the subscription. For the requirements on this format, see the documentation of the productId field on the Subscription resource. |\n| `regionsVersion` | `object (`[RegionsVersion](/android-publisher/api-ref/rest/v3/RegionsVersion)`)` Required. The version of the available regions being used for the subscription. |\n\n### Request body\n\nThe request body contains an instance of [Subscription](/android-publisher/api-ref/rest/v3/monetization.subscriptions#Subscription).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Subscription](/android-publisher/api-ref/rest/v3/monetization.subscriptions#Subscription).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
