تحقیرها

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

جدول زمانی منسوخ - 21 مه 2025 تا 31 اوت 2027

ویژگی‌ها و APIهای این بخش از 21 مه 2025 منسوخ شده‌اند و در 31 آگوست 2027 بسته خواهند شد. با این حال، می‌توانید تا 1 نوامبر 2027 از یک برنامه افزودنی برای موارد منسوخ شده استفاده کنید.

APIهای اشتراک منسوخ شده

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

API جایگزینی موجود
subscriptions.get subscriptionsv2.get
اشتراک ها.بازپرداخت برای دریافت SubscriptionPurchaseLineItem با subscriptionsv2.get تماس بگیرید. latest_successful_order_id، و سپس با Orders.refund تماس بگیرید تا سفارشات را بازپرداخت کنید.
اشتراک ها. لغو subscriptionsv2.revoke
اشتراک خرید V2. latestOrderId اشتراک خرید آیتم خط. آخرین_سفارش_موفق
RealTime Developer Notification. SubscriptionNotification.subscriptionId بدون جایگزینی
RealTime Developer Notification. اطلاعیه اشتراک. نوع اعلان SUBSCRIPTION_PRICE_CHANGE_CONFIRMED SUBSCRIPTION_PRICE _CHANGE_UPDATED

فیلدهای SubscriptionPurchaseV2 برای اشتراک های تکراری

purchases.subscriptionv2 حاوی فیلدهای جدیدی است که جزئیات بیشتری درباره اشیاء اشتراک جدید ارائه می دهد. جدول زیر نحوه فیلدها از نقشه نقطه پایانی اشتراک قدیمی به فیلدهای مربوطه در purchases.subscriptionv2 را نشان می‌دهد.

اشتراک خرید اشتراک خرید V2
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 برای هر یک از اشتراک های خریداری شده یافت.
توسعه دهنده Payload بار برنامه‌نویس (بدون فیلد معادل) منسوخ شده است
دولت پرداخت (بدون فیلد معادل)
می توانید وضعیت پرداخت را از subscriptionState استنباط کنید:
  • پرداخت در انتظار است:
    • SUBSCRIPTION_STATE_PENDING (خریدهای جدید با تراکنش معلق)
    • SUBSCRIPTION_STATE_IN_GRACE_PERIOD
    • SUBSCRIPTION_STATE_ON_HOLD
  • پرداخت دریافت شده است:
    • SUBSCRIPTION_STATE_ACTIVE
  • آزمایشی رایگان:
    • قسمت Order.line_items.subscription_details.offer_phase که می توانید توسط Orders.get API واکشی کنید.
  • ارتقا / تنزل معوق:
    • 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 همانطور که قبلا انجام دادید.