Method: monetization.subscriptions.basePlans.offers.activate
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Aktiviert ein Aboangebot. Nach der Aktivierung sind Aboangebote für neue Abonnenten verfügbar.
HTTP-Anfrage
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers/{offerId}:activate
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
packageName |
string
Erforderlich. Die übergeordnete App (Paketname) des Angebots, das aktiviert werden soll.
|
productId |
string
Erforderlich. Das übergeordnete Abo (ID) des zu aktivierenden Angebots.
|
basePlanId |
string
Erforderlich. Die ID des übergeordneten Basis-Abos, das aktiviert werden soll.
|
offerId |
string
Erforderlich. Die eindeutige Angebots-ID des zu aktivierenden Angebots.
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
| Felder |
latencyTolerance |
enum (ProductUpdateLatencyTolerance)
Optional. Die Latenztoleranz für die Weitergabe dieses Produktupdates. Die Standardeinstellung ist latenzempfindlich.
|
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von SubscriptionOffer.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/androidpublisher
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\u003cp\u003eActivates a subscription offer, making it available to new subscribers.\u003c/p\u003e\n"],["\u003cp\u003eRequires a POST request to a specific endpoint with package name, product ID, base plan ID, and offer ID.\u003c/p\u003e\n"],["\u003cp\u003eOptionally, includes latency tolerance for product update propagation within the request body.\u003c/p\u003e\n"],["\u003cp\u003eA successful activation returns a SubscriptionOffer object.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e authorization scope.\u003c/p\u003e\n"]]],["This document outlines how to activate a subscription offer via a POST HTTP request to the specified URL, utilizing gRPC Transcoding syntax. The request requires four path parameters: `packageName`, `productId`, `basePlanId`, and `offerId`. The request body optionally includes a `latencyTolerance` field within its JSON structure. A successful request returns a `SubscriptionOffer` instance in the response body. The `https://www.googleapis.com/auth/androidpublisher` OAuth scope is necessary for authorization.\n"],null,["# Method: monetization.subscriptions.basePlans.offers.activate\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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nActivates a subscription offer. Once activated, subscription offers will be available to new subscribers.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers/{offerId}:activate`\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 offer to activate. |\n| `productId` | `string` Required. The parent subscription (ID) of the offer to activate. |\n| `basePlanId` | `string` Required. The parent base plan (ID) of the offer to activate. |\n| `offerId` | `string` Required. The unique offer ID of the offer to activate. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------|\n| ``` { \"latencyTolerance\": enum (/android-publisher/api-ref/rest/v3/ProductUpdateLatencyTolerance) } ``` |\n\n| Fields ||\n|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `latencyTolerance` | `enum (`[ProductUpdateLatencyTolerance](/android-publisher/api-ref/rest/v3/ProductUpdateLatencyTolerance)`)` Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive. |\n\n### Response body\n\nIf successful, the response body contains an 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`"]]
