Method: monetization.subscriptions.basePlans.batchMigratePrices
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Batch-Variante des Endpunkts „basePlans.migratePrices“.
Legen Sie für das Feld "LatenzTolerance" bei verschachtelten Anfragen den Wert "PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT" fest, um einen maximalen Updatedurchsatz zu erreichen.
HTTP-Anfrage
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchMigratePrices
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter |
packageName |
string
Erforderlich. Die übergeordnete App (Paketname), für die die Abos erstellt oder aktualisiert werden sollen. Muss für alle Aboressourcen dem Feld „packageName“ entsprechen.
|
productId |
string
Erforderlich. Die Produkt-ID des übergeordneten Abos, wenn alle aktualisierten Angebote zum selben Abo gehören. Wenn diese Batch-Aktualisierung mehrere Abos umfasst, setzen Sie dieses Feld auf „-“. Muss festgelegt werden.
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
Felder |
requests[] |
object (MigrateBasePlanPricesRequest )
Erforderlich. Bis zu 100 Anfragen zur Preismigration. Bei allen Anfragen müssen verschiedene Basis-Abos aktualisiert werden.
|
Antworttext
Antwortnachricht für basePlans.batchMigratePrices.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
Felder |
responses[] |
object (MigrateBasePlanPricesResponse )
Enthält eine Antwort pro angeforderter Preismigration in derselben Reihenfolge wie die Anfrage.
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/androidpublisher
MigrateBasePlanPricesRequest
Anfragenachricht für basePlans.migratePrices.
Felder |
packageName |
string
Erforderlich. Paketname der übergeordneten App. Muss dem Feld „packageName“ in der Aboressource entsprechen.
|
productId |
string
Erforderlich. Die ID des Abos, das aktualisiert werden soll. Muss dem Feld „productId“ in der Aboressource entsprechen.
|
basePlanId |
string
Erforderlich. Die eindeutige Basis-Abo-ID des Basis-Abos, für das der Preis aktualisiert werden soll.
|
regionalPriceMigrations[] |
object (RegionalPriceMigrationConfig )
Erforderlich. Die zu aktualisierenden regionalen Preise.
|
regionsVersion |
object (RegionsVersion )
Erforderlich. Die Version der verfügbaren Regionen, die für regionalPriceMigrations verwendet wird.
|
latencyTolerance |
enum (ProductUpdateLatencyTolerance )
Optional. Die Latenztoleranz für die Weitergabe dieses Produktupdates. Die Standardeinstellung ist latenzempfindlich.
|
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\u003eUse this endpoint to migrate prices for up to 100 base plans within subscriptions, potentially across multiple subscriptions.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include details like the package name, product ID, base plan ID, regional price migrations, and regions version for each base plan.\u003c/p\u003e\n"],["\u003cp\u003eThis endpoint requires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eSet \u003ccode\u003elatencyTolerance\u003c/code\u003e to \u003ccode\u003ePRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT\u003c/code\u003e for potentially faster updates but with a higher chance of temporary inconsistencies.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a status for each requested price migration in the same order as the request.\u003c/p\u003e\n"]]],["This outlines a batch API endpoint for migrating base plan prices for Android subscriptions. It uses a POST request to `https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchMigratePrices`. The request body contains an array of `MigrateBasePlanPricesRequest`, specifying the `packageName`, `productId`, `basePlanId`, and `regionalPriceMigrations`. The response includes an array of `MigrateBasePlanPricesResponse`, mirroring the request order. The API requires `androidpublisher` authorization scope. Up to 100 price migration requests are allowed per call.\n"],null,["# Method: monetization.subscriptions.basePlans.batchMigratePrices\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.BatchMigrateBasePlanPricesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [MigrateBasePlanPricesRequest](#MigrateBasePlanPricesRequest)\n - [JSON representation](#MigrateBasePlanPricesRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nBatch variant of the basePlans.migratePrices endpoint.\n\nSet the latencyTolerance field on nested requests to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT to achieve maximum update throughput.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchMigratePrices`\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 Subscription resources. |\n| `productId` | `string` Required. The product ID of the parent subscription, if all updated offers belong to the same subscription. If this batch update spans multiple subscriptions, set this field to \"-\". Must be set. |\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/batchMigratePrices#MigrateBasePlanPricesRequest) } ] } ``` |\n\n| Fields ||\n|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (`[MigrateBasePlanPricesRequest](/android-publisher/api-ref/rest/v3/monetization.subscriptions.basePlans/batchMigratePrices#MigrateBasePlanPricesRequest)`)` Required. Up to 100 price migration requests. All requests must update different base plans. |\n\n### Response body\n\nResponse message for basePlans.batchMigratePrices.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------|\n| ``` { \"responses\": [ { object (/android-publisher/api-ref/rest/v3/MigrateBasePlanPricesResponse) } ] } ``` |\n\n| Fields ||\n|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `responses[]` | `object (`[MigrateBasePlanPricesResponse](/android-publisher/api-ref/rest/v3/MigrateBasePlanPricesResponse)`)` Contains one response per requested price migration, in the same order as the request. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`\n\nMigrateBasePlanPricesRequest\n----------------------------\n\nRequest message for basePlans.migratePrices.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"packageName\": string, \"productId\": string, \"basePlanId\": string, \"regionalPriceMigrations\": [ { object (/android-publisher/api-ref/rest/v3/RegionalPriceMigrationConfig) } ], \"regionsVersion\": { object (/android-publisher/api-ref/rest/v3/RegionsVersion) }, \"latencyTolerance\": enum (/android-publisher/api-ref/rest/v3/ProductUpdateLatencyTolerance) } ``` |\n\n| Fields ||\n|-----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `packageName` | `string` Required. Package name of the parent app. Must be equal to the packageName field on the Subscription resource. |\n| `productId` | `string` Required. The ID of the subscription to update. Must be equal to the productId field on the Subscription resource. |\n| `basePlanId` | `string` Required. The unique base plan ID of the base plan to update prices on. |\n| `regionalPriceMigrations[]` | `object (`[RegionalPriceMigrationConfig](/android-publisher/api-ref/rest/v3/RegionalPriceMigrationConfig)`)` Required. The regional prices to update. |\n| `regionsVersion` | `object (`[RegionsVersion](/android-publisher/api-ref/rest/v3/RegionsVersion)`)` Required. The version of the available regions being used for the regionalPriceMigrations. |\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. |"]]