Method: monetization.subscriptions.basePlans.offers.batchUpdate

更新一批訂閱商品。

將巢狀要求的 latencyTolerance 欄位設為 PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT，以便達到最高更新傳輸量。

HTTP 要求

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdate

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
packageName

string

必要欄位。更新後的訂閱項目主應用程式 (套件名稱)。

必須與所有更新的 SubscriptionOffer 資源的 packageName 欄位相等。
productId

string

必要欄位。如果所有更新的商品屬於同一個訂閱項目，則為父項訂閱項目的產品 ID。如果這項要求跨越多個訂閱項目，請將這個欄位設為「-」。必須設定。
basePlanId

string

必要欄位。應更新優惠的父項基本方案 (ID)。可指定為「-」，用於更新多個基本方案的優惠。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "requests": [
    {
      object (UpdateSubscriptionOfferRequest)
    }
  ]
}
欄位
requests[]

object (UpdateSubscriptionOfferRequest)

必要欄位。更新要求清單，最多包含 100 個元素。所有要求都必須更新不同的訂閱方案。

回應主體

offers.batchUpdate 的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "subscriptionOffers": [
    {
      object (SubscriptionOffer)
    }
  ]
}
欄位
subscriptionOffers[]

object (SubscriptionOffer)

更新後的訂閱項目清單。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/androidpublisher

UpdateSubscriptionOfferRequest

offers.patch 的要求訊息。

JSON 表示法 
{
  "subscriptionOffer": {
    object (SubscriptionOffer)
  },
  "updateMask": string,
  "regionsVersion": {
    object (RegionsVersion)
  },
  "allowMissing": boolean,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
欄位
subscriptionOffer

object (SubscriptionOffer)

必要欄位。要更新的訂閱方案。
updateMask

string (FieldMask format)

必要欄位。要更新的欄位清單。

這是以半形逗號分隔的完整欄位名稱清單。範例："user.displayName,photo"。
regionsVersion

object (RegionsVersion)

必要欄位。用於 subscriptionOffer 的可用地區版本。
allowMissing

boolean

選用設定。如果設為 true，且沒有含有指定 packageName、productId、basePlanId 和 offerId 的訂閱優惠，系統就會建立優惠。

如果建立新優惠，系統會忽略 updateMask。
latencyTolerance

enum (ProductUpdateLatencyTolerance)

選用設定。這項產品更新的傳播延遲容許值。預設為「延遲敏感」。