Method: monetization.subscriptions.basePlans.migratePrices

將接收歷來訂閱價格的訂閱者遷移至指定區域的目前價格。要求將接收到目前價格低於提供時間戳記的使用者,因而收到價格異動通知。如果不同意新版價格,訂閱項目將於下次續約時結束。

HTTP 要求

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

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

路徑參數

參數
packageName

string

必要,父項應用程式的套件名稱。必須等於 Subscription 資源的 packageName 欄位。

productId

string

必要,要更新的訂閱項目 ID。必須與訂閱資源的 productId 欄位相同。

basePlanId

string

必要,要更新價格的基本方案不重複基本方案 ID。

要求主體

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

JSON 表示法
{
  "regionalPriceMigrations": [
    {
      object (RegionalPriceMigrationConfig)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
欄位
regionalPriceMigrations[]

object (RegionalPriceMigrationConfig)

必要,要更新的區域價格。

regionsVersion

object (RegionsVersion)

必要,用於 RegionalPriceMigrations 的可用區域版本。

回應主體

如果成功,則回應內容為空白。

授權範圍

需要下列 OAuth 範圍:

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

區域價格遷移設定

價格遷移設定。

JSON 表示法
{
  "regionCode": string,
  "oldestAllowedPriceVersionTime": string
}
欄位
regionCode

string

必要,這項設定適用的區域代碼,如 ISO 3166-2 所定義,例如「US」。

oldestAllowedPriceVersionTime

string (Timestamp format)

必要,訂閱者可以繼續支付過往費用的截止時間。訂閱者如果在截止時間前建立價格,則會轉換成目前提供的價格。訂閱者將會收到不同的價格通知。如果不同意新版價格,訂閱項目將於下次續約時結束。

RFC3339 UTC 的「Zulu」格式時間戳記,單位為奈秒解析度,最多可達九位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"