更新批量订阅优惠。
将嵌套请求的 delayTolerance 字段设置为 PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT,以达到最大更新吞吐量。
HTTP 请求
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdate
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
packageName |
必需。已更新的订阅优惠的父级应用(软件包名称)。 必须等于所有已更新的 SubscriptionOffer 资源上的 packageName 字段。 |
productId |
必需。父级订阅的商品 ID(如果所有更新后的优惠都属于同一订阅)。如果该请求跨多个订阅,请将此字段设置为“-”(必须设置)。 |
basePlanId |
必需。需要更新其优惠的父级基础方案 (ID)。可指定为“-”以更新多个基础方案中的优惠。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{
"requests": [
{
object ( |
字段 | |
---|---|
requests[] |
必需。更新请求列表,最多包含 100 个元素。所有请求都必须更新不同的订阅优惠。 |
响应正文
Offer.batchUpdate 的响应消息。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"subscriptionOffers": [
{
object ( |
字段 | |
---|---|
subscriptionOffers[] |
更新后的订阅优惠列表。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/androidpublisher
UpdateSubscriptionOfferRequest
Offer.patch 的请求消息。
JSON 表示法 |
---|
{ "subscriptionOffer": { object ( |
字段 | |
---|---|
subscriptionOffer |
必需。要更新的订阅优惠。 |
updateMask |
必需。要更新的字段列表。 这是以逗号分隔的完全限定字段名称列表。示例: |
regionsVersion |
必需。用于 subscriptionOffer 的可用地区的版本。 |
allowMissing |
可选。如果设为 true,并且不存在具有指定 packageName、productId、basePlanId 和 offerId 的订阅优惠,系统将会创建优惠。 如果创建了新优惠,系统会忽略 updateMask。 |
latencyTolerance |
可选。此产品更新的传播的延迟容忍度。默认为对延迟敏感。 |