Method: monetization.subscriptions.basePlans.migratePrices

過去の定期購入価格が適用されている定期購入者が、指定された地域で現在提供されている価格に移行されます。リクエストを行うと、価格変更通知は、指定されたタイムスタンプより前の価格が現在適用されているユーザーに送信されます。定期購入者が新しい価格に同意しない場合は、次回の更新時に定期購入が終了します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
packageName

string

必須。親アプリのパッケージ名。Subscription リソースの packageName フィールドと同じにする必要があります。
productId

string

必須。更新する定期購入の ID。Subscription リソースの productId フィールドと同じにする必要があります。
basePlanId

string

必須。価格を更新する基本プランの一意の基本プラン ID。

リクエスト本文

リクエストの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "regionalPriceMigrations": [
    {
      object (RegionalPriceMigrationConfig)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
フィールド
regionalPriceMigrations[]

object (RegionalPriceMigrationConfig)

必須。更新する地域の価格です。
regionsVersion

object (RegionsVersion)

必須。regionPriceMigrations で使用されている利用可能なリージョンのバージョン。

レスポンスの本文

成功すると、レスポンスの本文は空になります。

認可スコープ

次の OAuth スコープが必要です。

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

RegionalPriceMigrationConfig

価格移行の構成。

JSON 表現 
{
  "regionCode": string,
  "oldestAllowedPriceVersionTime": string,
  "priceIncreaseType": enum (PriceIncreaseType)
}
フィールド
regionCode

string

必須。この構成が適用される地域コード。ISO 3166-2 で定義されています（例: 「US」）。
oldestAllowedPriceVersionTime

string (Timestamp format)

必須。定期購入者が支払いを継続できる過去の価格の締め切り時間。この受付終了時間より前に作成された価格を使用している定期購入者は、現在提供中の価格に移行されます。これらの登録者には、別の価格が支払われるという通知が届きます。定期購入者が新しい価格に同意しない場合は、次回の更新時に定期購入が終了します。

RFC3339 UTC「Zulu」形式のタイムスタンプ。ナノ秒の解像度で小数点以下 9 桁まで指定できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
priceIncreaseType

enum (PriceIncreaseType)

（省略可）呼び出し元が、移行中に値上げがあった場合にユーザーに確認を求める動作。未設定のままにした場合、デフォルトは PRICE_INCREASE_TYPE_OPT_IN です。各アプリの最初のオプトアウトによる値上げの移行は、Google Play Console で開始する必要があります。

値上げの種類

価格の移行のタイプ。

列挙型
PRICE_INCREASE_TYPE_UNSPECIFIED 未指定の状態
PRICE_INCREASE_TYPE_OPT_IN 値上げはユーザーの意思に沿って表示されます。
PRICE_INCREASE_TYPE_OPT_OUT 値上げはオプトアウト方式でユーザーに表示されます。