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 Console. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 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. |"]]
