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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
|
priceIncreaseType |
enum (PriceIncreaseType)
אופציונלי. סוג העלייה במחיר המבוקש
|
PriceIncreaseType
סוג העברת המחירים המבוקש.
| טיפוסים בני מנייה (enum) |
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 (שעון 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. |"]]
