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

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

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

התכונות ו-APIs שבקטע הזה יוצאו משימוש ב-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 (רשימת SubscriptionPurchaseLineItem) שמייצגת את המוצרים שנרכשו ברכישה
(אין שדה מקביל) 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 (אין שדה מקביל)
המידע הזה מופיע ב-offer של כל אחד מהמינויים שנרכשו.
developerPayload (אין שדה מקביל) עומס העבודה של המפתח הוצא משימוש
paymentState (אין שדה מקביל)
אפשר להסיק את סטטוס התשלום מהשדה subscriptionState:
  • התשלום בהמתנה:
    • SUBSCRIPTION_STATE_PENDING (רכישות חדשות עם עסקה בהמתנה)
    • SUBSCRIPTION_STATE_IN_GRACE_PERIOD
    • SUBSCRIPTION_STATE_ON_HOLD
  • התשלום התקבל:
    • SUBSCRIPTION_STATE_ACTIVE
  • תקופת ניסיון בחינם:
    • השדה Order.line_items.subscription_details.offer_phase, שאפשר לאחזר באמצעות ה-API Orders.get.
  • שדרוג / שדרוג לאחור נדחים:
    • 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 כמו בעבר.