RegionalPriceMigrationConfig
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
| JSON 表現 |
{
"regionCode": string,
"oldestAllowedPriceVersionTime": string,
"priceIncreaseType": enum (PriceIncreaseType)
} |
| フィールド |
regionCode |
string
必須。この設定が適用される地域コード（ISO 3166-2 形式で定義。例: 「US」）。
|
oldestAllowedPriceVersionTime |
string (Timestamp format)
必須。この日付より前の以前の価格コホートのすべての定期購入者は、現在の価格に移行されます。新しい価格コホートの定期購入者には影響しません。該当する定期購入者には、料金改定について Google Play から 1 通以上の通知が届きます。値下げは、定期購入者の次回の請求日に適用されます。値上げは、地域と値上げの種類によって異なる通知期間の後に、定期購入者の次回の請求日に実施されます。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
|
priceIncreaseType |
enum (PriceIncreaseType)
省略可。リクエストされた値上げの種類
|
PriceIncreaseType
| 列挙型 |
PRICE_INCREASE_TYPE_UNSPECIFIED |
未指定の状態 |
PRICE_INCREASE_TYPE_OPT_IN |
定期購入者は値上げに同意する必要があります。同意しない場合、定期購入は解約されます。 |
PRICE_INCREASE_TYPE_OPT_OUT |
定期購入者に通知はされますが、値上げに同意する必要はありません。地域、頻度、金額の制限を満たしていないオプトアウトの値上げは、オプトインによる値上げとして処理されます。各アプリを最初にオプトアウト ベースで値上げして移行する場合は、Google Play Console で始める必要があります。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-26 UTC。
[null,null,["最終更新日 2025-07-26 UTC。"],[[["\u003cp\u003eDefines the configuration for migrating legacy price cohorts for subscriptions in a specific region.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the region and the cutoff time for migrating subscribers from older price cohorts to the current price.\u003c/p\u003e\n"],["\u003cp\u003eAllows for specifying the type of price increase, which impacts how subscribers are notified and whether they need to opt in.\u003c/p\u003e\n"],["\u003cp\u003eSubscribers migrated to the new price will receive notifications, with price changes applied at their next billing date.\u003c/p\u003e\n"],["\u003cp\u003eOpt-out price increases might be converted to opt-in if they exceed regional limits or frequency restrictions.\u003c/p\u003e\n"]]],["This document details the configuration for migrating legacy price cohorts. Key elements include: `regionCode`, a required string indicating the region (e.g., \"US\"); `oldestAllowedPriceVersionTime`, a required timestamp specifying which price cohorts will be migrated; and `priceIncreaseType`, an optional enum. The `priceIncreaseType` defines if subscribers must opt-in or can opt-out of the price increase. The timestamp determines which subscribers will have their pricing changed and receive a notification.\n"],null,["# RegionalPriceMigrationConfig\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [PriceIncreaseType](#PriceIncreaseType)\n\nConfiguration for migration of a legacy price cohort.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"regionCode\": string, \"oldestAllowedPriceVersionTime\": string, \"priceIncreaseType\": enum (/android-publisher/api-ref/rest/v3/RegionalPriceMigrationConfig#PriceIncreaseType) } ``` |\n\n| Fields ||\n|---------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `regionCode` | `string` Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g. \"US\". |\n| `oldestAllowedPriceVersionTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Required. Subscribers in all legacy price cohorts before this time will be migrated to the current price. Subscribers in any newer price cohorts are unaffected. Affected subscribers will receive one or more notifications from Google Play about the price change. Price decreases occur at the subscriber's next billing date. Price increases occur at the subscriber's next billing date following a notification period that varies by region and price increase type. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `priceIncreaseType` | `enum (`[PriceIncreaseType](/android-publisher/api-ref/rest/v3/RegionalPriceMigrationConfig#PriceIncreaseType)`)` Optional. The requested type of price increase |\n\nPriceIncreaseType\n-----------------\n\nThe requested type of price migration.\n\n| Enums ||\n|-----------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `PRICE_INCREASE_TYPE_UNSPECIFIED` | Unspecified state. |\n| `PRICE_INCREASE_TYPE_OPT_IN` | Subscribers must accept the price increase or their subscription is canceled. |\n| `PRICE_INCREASE_TYPE_OPT_OUT` | Subscribers are notified but do not have to accept the price increase. Opt-out price increases not meeting regional, frequency, and amount limits will proceed as opt-in price increase. The first opt-out price increase for each app must be initiated in the Google Play Console. |"]]
