Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

• HTTP 要求
• 路徑參數
• 要求主體
  • JSON 表示法
• 回應主體
  • JSON 表示法
• 授權範圍
• UpdateSubscriptionOfferStateRequest
  • JSON 表示法
• ActivateSubscriptionOfferRequest
  • JSON 表示法
• DeactivateSubscriptionOfferRequest
  • JSON 表示法
• 試試看！

更新一批訂閱商品的狀態。

將巢狀要求的 latencyTolerance 欄位設為 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 個元素。所有要求都必須更新不同的產品。

回應主體

offers.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

要求訊息 (offers.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) 選用設定。這項產品更新的傳播延遲容許值。預設為「延遲敏感」。