תכונות שיצאו משימוש

במאמר הזה מפורטים ממשקי Google Play Developer API והתכונות הקשורות שנמצאים בתקופת הוצאה משימוש.

לוח הזמנים להוצאה משימוש – 21 במאי 2025 עד 31 באוגוסט 2027

התכונות וממשקי ה-API שמופיעים בקטע הזה הוצאו משימוש ב-21 במאי 2025, והם יושבתו ב-31 באוגוסט 2027. עם זאת, אפשר לקבל הארכה לשימוש בפריטים שהוצאו משימוש עד 1 בנובמבר 2027.

ממשקי API שהוצאו משימוש בנושא מינויים

בקטע הזה מפורטות הוצאות משימוש של ממשקי API.

API	החלפה זמינה
subscriptions.get	subscriptionsv2.get
subscriptions.refund	מתקשרים אל subscriptionsv2.get כדי לקבל SubscriptionPurchaseLineItem. ‫latest_successful_order_id, ואז קוראים ל-Orders.refund כדי לבצע החזר כספי על ההזמנות.
subscriptions.revoke	subscriptionsv2.revoke
SubscriptionPurchaseV2. latestOrderId	SubscriptionPurchaseLineItem. latest_successful_order_id
RealTimeDeveloperNotification. SubscriptionNotification.subscriptionId	ללא החלפה
RealTimeDeveloperNotification. SubscriptionNotification. notificationType SUBSCRIPTION_PRICE_CHANGE_CONFIRMED	SUBSCRIPTION_PRICE _CHANGE_UPDATED

שדות של SubscriptionPurchaseV2 למינויים חוזרים

‫purchases.subscriptionv2 מכיל שדות חדשים שמספקים פרטים נוספים על אובייקטים חדשים של מינויים. בטבלה הבאה מוצג מיפוי של שדות מנקודת הקצה של המינוי מדור קודם לשדות תואמים ב-purchases.subscriptionv2.

SubscriptionPurchase	SubscriptionPurchaseV2
`countryCode`	`regionCode`
`orderId`	`SubscriptionPurchaseLineItem.latest_successful_order_id`
(אין שדה מקביל)	`lineItems.offerPhase` (מציין את השלב הנוכחי: תקופת ניסיון בחינם, מחיר היכרות, חיוב יחסי, מחיר בסיסי)
(אין שדה מקביל)	`lineItems` (list of SubscriptionPurchaseLineItem) that represents the products acquired with the purchase
(אין שדה מקביל)	`lineItems.offerDetails.basePlanId`
(אין שדה מקביל)	`lineItems.offerDetails.offerId`
(אין שדה מקביל)	`lineItems.offerDetails.offerTags`
`startTimeMillis`	`startTime`
`expiryTimeMillis`	‫`lineItems.expiryTime` (לכל מינוי שנרכש יש `expiryTime` משלו)
(אין שדה מקביל)	‫`subscriptionState` (מציין את מצב המינוי)
(אין שדה מקביל)	`pausedStateContext` (מופיע רק אם סטטוס המינוי הוא `SUBSCRIPTION_STATE_PAUSED`)
`autoResumeTimeMillis`	`pausedStateContext.autoResumeTime`
(אין שדה מקביל)	‫`canceledStateContext` (מופיע רק אם סטטוס המינוי הוא `SUBSCRIPTION_STATE_CANCELED`)
(אין שדה מקביל)	‫`testPurchase` (מופיע רק ברכישות של בודקים מורשים)
`autoRenewing`	`lineItems.autoRenewingPlan.autoRenewEnabled`
`priceCurrenceCode`, `priceAmountMicros`	`lineItems.autoRenewingPlan.recurringPrice`
`introductoryPriceInfo`	`lineItems.offerPhase.introductoryPrice` המידע הזה מופיע גם ב`offer` של כל מינוי שרכשתם.
developerPayload	(no equivalent field) developer payload has been deprecated
paymentState	(אין שדה מקביל) אפשר להסיק את סטטוס התשלום מ-`subscriptionState`: התשלום בהמתנה: `SUBSCRIPTION_STATE_PENDING` (רכישות חדשות עם עסקה בהמתנה) `SUBSCRIPTION_STATE_IN_GRACE_PERIOD` `SUBSCRIPTION_STATE_ON_HOLD` התשלום התקבל: `SUBSCRIPTION_STATE_ACTIVE` תקופת ניסיון בחינם: lineItems.offerPhase.freeTrial שדרוג או שדרוג לאחור שנדחו: `SUBSCRIPTION_STATE_PENDING`
`cancelReason`, `userCancellationTimeMillis`, `cancelSurveyResult`	`canceledStateContext`
`linkedPurchaseToken`	`linkedPurchaseToken` (ללא שינוי)
`purchaseType`	בדיקה: עד `testPurchase` מבצע: `signupPromotion`
`priceChange`	`lineItems.autoRenewingPlan.priceChangeDetails`
`profileName`, `emailAddress`, `givenName`, `familyName`, `profileId`	`subscribeWithGoogleInfo`
`acknowledgementState`	`acknowledgementState (no change)`
`promotionType`, `promotionCode`	`signupPromotion`
`externalAccountId`, `obfuscatedExternalAccountId`, `obfuscatedExteranlProfileId`	`externalAccountIdentifiers`

פונקציות אחרות לניהול מינויים

הגרסה של purchases.subscriptions:get שודרגה לגרסה purchases.subscriptionsv2:get, אבל שאר הפונקציות לניהול מינויים למפתחים נשארו ללא שינוי בינתיים בנקודת הקצה purchases.subscriptions, כך שאפשר להמשיך להשתמש בפונקציות purchases.subscriptions:acknowledge,‏ purchases.subscriptions:cancel,‏ purchases.subscriptions:defer,‏ purchases.subscriptions:refund ו-purchases.subscriptions:revoke כמו קודם.