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 で開始する必要があります。

PriceIncreaseType

価格の移行のタイプ。

列挙型
PRICE_INCREASE_TYPE_UNSPECIFIED 未指定の状態
PRICE_INCREASE_TYPE_OPT_IN 値上げはオプトイン ベースでユーザーに提示されます。
PRICE_INCREASE_TYPE_OPT_OUT 値上げはオプトアウト ベースでユーザーに表示されます。