Method: monetization.subscriptions.basePlans.batchMigratePrices
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
basePlans.migrationPrices uç noktasının toplu varyantı.
Maksimum güncelleme işleme hızına ulaşmak için iç içe yerleştirilmiş isteklerdeki gecikmeTolerance alanını PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT olarak ayarlayın.
HTTP isteği
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchMigratePrices
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler |
packageName |
string
Zorunlu. Aboneliklerin oluşturulması veya güncellenmesi gereken üst uygulama (paket adı). Tüm Abonelik kaynaklarındaki packageName alanına eşit olmalıdır.
|
productId |
string
Zorunlu. Güncellenen tüm teklifler aynı aboneliğe aitse üst aboneliğin ürün kimliği. Bu toplu güncelleme birden fazla aboneliği kapsıyorsa bu alanı "-" olarak ayarlayın. Ayarlanmalıdır.
|
İstek içeriği
İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:
Alanlar |
requests[] |
object (MigrateBasePlanPricesRequest )
Zorunlu. En fazla 100 fiyat taşıma isteği. Tüm istekler farklı temel planları güncellemelidir.
|
Yanıt gövdesi
basePlans.batchMigratePrices için yanıt mesajı.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
Alanlar |
responses[] |
object (MigrateBasePlanPricesResponse )
İstenen her fiyat taşıma işlemi için istekle aynı sırada bir yanıt içerir.
|
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/androidpublisher
MigrateBasePlanPricesRequest
basePlans.MigratePrices için istek mesajı.
Alanlar |
packageName |
string
Zorunlu. Üst uygulamanın paket adı. Abonelik kaynağındaki packageName alanına eşit olmalıdır.
|
productId |
string
Zorunlu. Güncellenecek aboneliğin kimliği. Abonelik kaynağındaki productId alanına eşit olmalıdır.
|
basePlanId |
string
Zorunlu. Fiyatların güncelleneceği temel planın benzersiz temel plan kimliği.
|
regionalPriceMigrations[] |
object (RegionalPriceMigrationConfig )
Zorunlu. Güncellenecek bölgesel fiyatlar.
|
regionsVersion |
object (RegionsVersion )
Zorunlu. BölgeselPriceMigrations için kullanılan mevcut bölgelerin sürümü.
|
latencyTolerance |
enum (ProductUpdateLatencyTolerance )
İsteğe bağlı. Bu ürün güncellemesinin yayılmasına ilişkin gecikme toleransı. Varsayılan olarak gecikmeye duyarlıdır.
|
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-26 UTC.
[null,null,["Son güncelleme tarihi: 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. |"]]