הוצאה משימוש

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

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

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

הערה: ספריות לקוח שיוצאו אחרי 1 בנובמבר 2025 לא יכללו יותר את התכונות וממשקי ה-API האלה. עם זאת, עדיין אפשר לגשת לספריות קיימות עד לתאריך ההשבתה.

ממשקי 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 כמו קודם.