Method: monetization.subscriptions.batchUpdate
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Abonelik grubunu günceller.
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:batchUpdate
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler |
packageName |
string
Zorunlu. Aboneliklerin güncellenmesi gereken üst uygulama (paket adı). Tüm Abonelik kaynaklarındaki packageName alanına eşit olmalıdır.
|
İstek içeriği
İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:
Alanlar |
requests[] |
object (UpdateSubscriptionRequest )
Zorunlu. En fazla 100 öğelik güncelleme isteklerinin listesi. Tüm istekler farklı abonelikleri güncellemelidir.
|
Yanıt gövdesi
BatchUpdateSubscription için yanıt mesajı.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
{
"subscriptions": [
{
object (Subscription )
}
]
} |
Alanlar |
subscriptions[] |
object (Subscription )
Güncellenen abonelik listesi.
|
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/androidpublisher
UpdateSubscriptionRequest
abonelikleriniz.yama için istek mesajı.
Alanlar |
subscription |
object (Subscription )
Zorunlu. Güncellenecek abonelik.
|
updateMask |
string (FieldMask format)
Zorunlu. Güncellenecek alanların listesi. Bu, tam nitelikli alan adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo" .
|
regionsVersion |
object (RegionsVersion )
Zorunlu. Abonelik için kullanılan kullanılabilir bölgelerin sürümü.
|
allowMissing |
boolean
İsteğe bağlı. Doğru değerine ayarlanırsa ve belirtilen packageName ile productId'ye sahip abonelik mevcut değilse abonelik oluşturulur. Yeni bir abonelik oluşturulursa updateMask yoksayılır.
|
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\u003eUpdates a batch of up to 100 subscriptions for a specified Android app package.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing a list of \u003ccode\u003eUpdateSubscriptionRequest\u003c/code\u003e objects, each specifying the subscription to update and desired changes.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes an HTTP POST request to \u003ccode\u003ehttps://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions:batchUpdate\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAllows for creating new subscriptions if they don't exist by setting \u003ccode\u003eallowMissing\u003c/code\u003e to true within the \u003ccode\u003eUpdateSubscriptionRequest\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eOffers control over update propagation latency using the \u003ccode\u003elatencyTolerance\u003c/code\u003e field for optimized throughput.\u003c/p\u003e\n"]]],["This document details the process of batch updating subscriptions via an HTTP POST request to `https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions:batchUpdate`. The request body includes a list of `UpdateSubscriptionRequest` objects, each specifying a subscription to update, fields to modify, and region information. The response body returns a list of updated `Subscription` objects. A maximum of 100 requests is allowed and `packageName` must be specified. Optionally, new subscriptions can be created if they do not exist.\n"],null,["# Method: monetization.subscriptions.batchUpdate\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.BatchUpdateSubscriptionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [UpdateSubscriptionRequest](#UpdateSubscriptionRequest)\n - [JSON representation](#UpdateSubscriptionRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nUpdates a batch of subscriptions.\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:batchUpdate`\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 updated. Must be equal to the packageName field on all the Subscription resources. |\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/batchUpdate#UpdateSubscriptionRequest) } ] } ``` |\n\n| Fields ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (`[UpdateSubscriptionRequest](/android-publisher/api-ref/rest/v3/monetization.subscriptions/batchUpdate#UpdateSubscriptionRequest)`)` Required. A list of update requests of up to 100 elements. All requests must update different subscriptions. |\n\n### Response body\n\nResponse message for BatchUpdateSubscription.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"subscriptions\": [ { object (/android-publisher/api-ref/rest/v3/monetization.subscriptions#Subscription) } ] } ``` |\n\n| Fields ||\n|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------|\n| `subscriptions[]` | `object (`[Subscription](/android-publisher/api-ref/rest/v3/monetization.subscriptions#Subscription)`)` The updated subscriptions list. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`\n\nUpdateSubscriptionRequest\n-------------------------\n\nRequest message for subscriptions.patch.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"subscription\": { object (/android-publisher/api-ref/rest/v3/monetization.subscriptions#Subscription) }, \"updateMask\": string, \"regionsVersion\": { object (/android-publisher/api-ref/rest/v3/RegionsVersion) }, \"allowMissing\": boolean, \"latencyTolerance\": enum (/android-publisher/api-ref/rest/v3/ProductUpdateLatencyTolerance) } ``` |\n\n| Fields ||\n|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `subscription` | `object (`[Subscription](/android-publisher/api-ref/rest/v3/monetization.subscriptions#Subscription)`)` Required. The subscription to update. |\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Required. The list of fields to be updated. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n| `regionsVersion` | `object (`[RegionsVersion](/android-publisher/api-ref/rest/v3/RegionsVersion)`)` Required. The version of the available regions being used for the subscription. |\n| `allowMissing` | `boolean` Optional. If set to true, and the subscription with the given packageName and productId doesn't exist, the subscription will be created. If a new subscription is created, updateMask is ignored. |\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. |"]]