Method: monetization.subscriptions.batchUpdate
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Cập nhật một loạt các gói thuê bao.
Đặt trường latencyTolerance trên các yêu cầu lồng nhau thành PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT để đạt được thông lượng cập nhật tối đa.
Yêu cầu HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions:batchUpdate
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số |
packageName |
string
Bắt buộc. Ứng dụng mẹ (tên gói) cần cập nhật các gói thuê bao. Phải bằng trường packageName trên tất cả tài nguyên Gói thuê bao.
|
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Trường |
requests[] |
object (UpdateSubscriptionRequest )
Bắt buộc. Danh sách các yêu cầu cập nhật gồm tối đa 100 phần tử. Tất cả các yêu cầu phải cập nhật các gói thuê bao khác nhau.
|
Nội dung phản hồi
Thông báo phản hồi cho BatchUpdateSubscription.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
{
"subscriptions": [
{
object (Subscription )
}
]
} |
Trường |
subscriptions[] |
object (Subscription )
Danh sách gói thuê bao đã cập nhật.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/androidpublisher
UpdateSubscriptionRequest
Yêu cầu thông báo cho subscription.patch.
Trường |
subscription |
object (Subscription )
Bắt buộc. Gói thuê bao cần cập nhật.
|
updateMask |
string (FieldMask format)
Bắt buộc. Danh sách các trường cần cập nhật. Đây là danh sách các tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"
|
regionsVersion |
object (RegionsVersion )
Bắt buộc. Phiên bản của khu vực hiện có đang được dùng cho gói thuê bao đó.
|
allowMissing |
boolean
Không bắt buộc. Nếu bạn đặt chính sách này thành true và gói thuê bao có packageName cũng như productId đã cung cấp không tồn tại, thì gói thuê bao sẽ được tạo. Nếu một gói thuê bao mới được tạo, thì updateMask sẽ bị bỏ qua.
|
latencyTolerance |
enum (ProductUpdateLatencyTolerance )
Không bắt buộc. Dung sai độ trễ cho việc truyền tải bản cập nhật sản phẩm này. Giá trị mặc định là nhạy cảm với độ trễ.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]