Method: monetization.subscriptions.batchUpdate

更新批次訂閱項目。

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

HTTP 要求

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions:batchUpdate

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

路徑參數

參數
packageName

string

必要欄位。要更新訂閱項目的父項應用程式 (套件名稱)。必須等於所有訂閱項目資源的 packageName 欄位。

要求主體

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

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

object (UpdateSubscriptionRequest)

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

回應主體

BatchUpdateSubscription 的回應訊息。

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

JSON 表示法 
{   "subscriptions": [     {       object (Subscription)     }   ] }
欄位
subscriptions[]

object (Subscription)

更新後的訂閱項目清單。

授權範圍

需要下列 OAuth 範圍：

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

UpdateSubscriptionRequest

針對 subscription.patch 的要求訊息。

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

object (Subscription)

必要欄位。要更新的訂閱項目。
updateMask

string (FieldMask format)

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

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

object (RegionsVersion)

必要欄位。用於訂閱項目的可用地區版本。
allowMissing

boolean

選用設定。如果設為 true，且指定 packageName 和 productId 的訂閱項目不存在，系統將建立訂閱項目。

如果建立新的訂閱項目，系統會忽略 updateMask。
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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