הוצאה משימוש

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

לוח הזמנים להוצאה משימוש – 19 במאי 2026 עד 31 באוגוסט 2028

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

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

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

API החלפה זמינה
subscriptions.cancel subscriptionsv2.cancel
subscriptions.defer subscriptionsv2.defer
Order.lineItems.subscriptionDetails.offer_phase Order.lineItems.subscriptionDetails.offer_phase_details

לוח הזמנים להוצאה משימוש – 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 lineItems.latestSuccessfulOrderId
אפשר למצוא את מזהה ההזמנה בהמתנה בכתובת inGracePeriodStateContext.renewalDeclined.pendingOrderId או בכתובת onHoldStateContext.renewalDeclined.pendingOrderId.
startTimeMillis startTime
expiryTimeMillis ‫lineItems.expiryTime (לכל מינוי שנרכש יש expiryTime משלו)
autoResumeTimeMillis pausedStateContext.autoResumeTime
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
  • שדרוג או שדרוג לאחור שנדחו:
    • lineItems.deferredItemReplacement
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