منسوخ‌سازی‌ها

این سند Google Play Developer API و ویژگی‌های مرتبطی را که در دوره منسوخ شدن هستند فهرست می‌کند.

خط زمان منسوخ شدن - ۱۹ مه ۲۰۲۶ تا ۳۱ اوت ۲۰۲۸

ویژگی‌ها و میاناهای برنامه‌سازی کاربردی در این بخش از ۱۹ مه ۲۰۲۶ منسوخ شده‌اند و در ۳۱ اوت ۲۰۲۸ غیرفعال خواهند شد. برای موارد منسوخ‌شده، می‌توانید با ارسال بلیت پشتیبانی ازطریق کنسول Play > راهنما، درخواست تمدید مهلت تا ۱ نوامبر ۲۰۲۸ را ارائه دهید.

میاناهای برنامه‌سازی کاربردی اشتراک منسوخ‌شده

این بخش موارد منسوخ‌شده میانای برنامه‌سازی کاربردی را فهرست می‌کند.

API جایگزین دردسترس
subscriptions.cancel subscriptionsv2.cancel
subscriptions.defer subscriptionsv2.defer
Order.lineItems.subscriptionDetails.offer_phase Order.lineItems.subscriptionDetails.offer_phase_details

خط زمان منسوخ شدن - ۲۱ مه ۲۰۲۵ تا ۳۱ اوت ۲۰۲۷

ویژگی‌ها و میاناهای برنامه‌سازی کاربردی در این بخش از ۲۱ مه ۲۰۲۵ منسوخ شده‌اند و در ۳۱ اوت ۲۰۲۷ غیرفعال خواهند شد. برای موارد منسوخ‌شده، می‌توانید با ارسال بلیت پشتیبانی ازطریق کنسول Play > راهنما، درخواست تمدید تا ۱ نوامبر ۲۰۲۷ را ارائه دهید.

میاناهای برنامه‌سازی کاربردی اشتراک منسوخ‌شده

این بخش موارد منسوخ‌شده میانای برنامه‌سازی کاربردی را فهرست می‌کند.

API جایگزین دردسترس
subscriptions.get subscriptionsv2.get
subscriptions.refund برای دریافت SubscriptionPurchaseLineItem، subscriptionsv2.get را فراخوانی کنید. 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 (فیلد معادل وجود ندارد) محموله توسعه‌دهنده منسوخ شده است
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