Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

更新訂閱優惠狀態批次。

將巢狀要求的延遲時間 Tolerance 欄位設為 PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT,才能達到最大更新處理量。

HTTP 要求

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

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

路徑參數

參數
packageName

string

必要欄位。更新訂閱項目優惠的上層應用程式 (套件名稱)。

必須等於所有已更新 SubscriptionOffer 資源中的 packageName 欄位。

productId

string

必要欄位。如果所有更新後的優惠都屬於同一個訂閱項目,則父項訂閱項目的產品 ID。如果這項要求涵蓋多個訂閱項目,請將這個欄位設為「-」。必須設定。

basePlanId

string

必要欄位。要更新優惠的上層基本方案 (ID)。可以指定為「-」更新多個基本方案的優惠。

要求主體

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

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

object (UpdateSubscriptionOfferStateRequest)

必要欄位。更新要求清單,最多包含 100 個元素。所有要求都必須更新不同優惠。

回應主體

offer.batchUpdateStates 的回應訊息。

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

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

object (SubscriptionOffer)

更新後的訂閱項目優惠清單。

授權範圍

需要下列 OAuth 範圍:

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

UpdateSubscriptionOfferStateRequest

要求訊息更新訂閱優惠狀態。

JSON 表示法
{

  // Union field state_transition_type can be only one of the following:
  "activateSubscriptionOfferRequest": {
    object (ActivateSubscriptionOfferRequest)
  },
  "deactivateSubscriptionOfferRequest": {
    object (DeactivateSubscriptionOfferRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
欄位
聯集欄位 state_transition_type。要套用的狀態轉換類型,只能設定一項。state_transition_type 只能是下列其中一項:
activateSubscriptionOfferRequest

object (ActivateSubscriptionOfferRequest)

啟用優惠。啟用後,新訂閱者就能享有這項優惠。

deactivateSubscriptionOfferRequest

object (DeactivateSubscriptionOfferRequest)

停用優惠。停用方案後,新訂閱者就無法享有這項優惠,但現有訂閱者仍可繼續訂閱

ActivateSubscriptionOfferRequest

ActivateSubscriptionOffer 的要求訊息。

JSON 表示法
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
欄位
packageName

string

必要欄位。要啟用優惠的父項應用程式 (套件名稱)。

productId

string

必要欄位。要啟用的優惠父項訂閱項目 (ID)。

basePlanId

string

必要欄位。要啟用優惠的上層基本方案 (ID)。

offerId

string

必要欄位。要啟用的優惠專屬優惠 ID。

latencyTolerance

enum (ProductUpdateLatencyTolerance)

選用設定。這項產品更新傳播的延遲時間容忍度。預設為易受延遲時間影響。

DeactivateSubscriptionOfferRequest

要求 Offer.deactivate 的訊息。

JSON 表示法
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
欄位
packageName

string

必要欄位。要停用優惠的父項應用程式 (套件名稱)。

productId

string

必要欄位。要停用優惠的上層訂閱項目 (ID)。

basePlanId

string

必要欄位。要停用優惠的父項基本方案 (ID)。

offerId

string

必要欄位。要停用優惠的專屬優惠 ID。

latencyTolerance

enum (ProductUpdateLatencyTolerance)

選用設定。這項產品更新傳播的延遲時間容忍度。預設為易受延遲時間影響。