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

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

المخطط الزمني لإيقاف الميزة نهائيًا: من 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 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 لكل من الاشتراكات التي تم شراؤها.
developerPayload (لا يتوفّر حقل مكافئ) تم إيقاف الحمولة البرمجية للمطوّر نهائيًا
paymentState (لا يتوفّر حقل مكافئ)
يمكنك استنتاج حالة الدفع من 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
  • الترقية أو التقليل المؤجّل للإصدار:
    • 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.