الميزات التي سيتم إيقافها نهائيًا

يسرد هذا المستند واجهات Google Play Developer API والميزات ذات الصلة التي تمر بفترة إيقاف نهائي.

المخطط الزمني لإيقاف الميزة نهائيًا: من 19 مايو 2026 إلى 31 أغسطس 2028

تم إيقاف الميزات وواجهات برمجة التطبيقات الواردة في هذا القسم نهائيًا اعتبارًا من 19 مايو 2026، وسيتم إيقافها بالكامل في 31 أغسطس 2028. بالنسبة إلى العناصر المتوقّفة نهائيًا، يمكنك طلب تمديد الموعد النهائي حتى 1 نوفمبر 2028 من خلال إرسال طلب دعم عبر Play Console > المساعدة.

واجهات برمجة التطبيقات المتوقّفة للاشتراكات

يسرد هذا القسم عمليات إيقاف واجهات برمجة التطبيقات نهائيًا.

واجهة برمجة التطبيقات الاستبدال المتاح
subscriptions.cancel subscriptionsv2.cancel
subscriptions.defer subscriptionsv2.defer
Order.lineItems.subscriptionDetails.offer_phase Order.lineItems.subscriptionDetails.offer_phase_details

المخطط الزمني لإيقاف الميزة نهائيًا: من 21 مايو 2025 إلى 31 أغسطس 2027

تم إيقاف الميزات وواجهات برمجة التطبيقات الواردة في هذا القسم نهائيًا اعتبارًا من 21 مايو 2025، وسيتم إيقافها بالكامل في 31 أغسطس 2027. بالنسبة إلى العناصر المتوقّفة نهائيًا، يمكنك طلب تمديد الموعد النهائي حتى 1 نوفمبر 2027 من خلال إرسال طلب دعم عبر Play Console > المساعدة.

واجهات برمجة التطبيقات المتوقّفة للاشتراكات

يسرد هذا القسم عمليات إيقاف واجهات برمجة التطبيقات نهائيًا.

واجهة برمجة التطبيقات الاستبدال المتاح
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 تم إيقاف حمولة المطوّر (لا يوجد حقل مكافئ) نهائيًا
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