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

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

الجدول الزمني لإيقاف واجهات برمجة التطبيقات والميزات: من 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