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

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

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

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

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

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

واجهة برمجة التطبيقات البديل المتاح
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.

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

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

واجهة برمجة التطبيقات البديل المتاح
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