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 管理中心内发起。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):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. |"]]