RegionalPriceMigrationConfig
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
| JSON 表示法 |
{
"regionCode": string,
"oldestAllowedPriceVersionTime": string,
"priceIncreaseType": enum (PriceIncreaseType)
} |
| 欄位 |
regionCode |
string
必要欄位。這項設定適用的區域代碼，請參考 ISO 3166-2 的定義，例如「US」。
|
oldestAllowedPriceVersionTime |
string (Timestamp format)
必要欄位。在此之前，所有舊版價格同類群組的訂閱者都會改為採用目前價格。任何新價格同類群組的訂閱者都不會受到影響。受影響的訂閱者會收到一或多則 Google Play 價格異動通知。系統會在訂閱者的下一個帳單日調降價格。在通知期過後，訂閱者會在下一個帳單結算日收到漲價通知，通知期長度會因地區和漲價類型而異。 使用 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 管理中心啟用。 |
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\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. |"]]
