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

يسرد هذا المستند واجهات 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, and then call Orders.refund to refund the orders.
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.offerPhase` (تحدّد المرحلة الحالية: فترة تجريبية مجانية أو سعر تمهيدي أو تسوية نسبية أو سعر أساسي)
(ما مِن حقل مكافئ)	`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`	`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 الترقية أو خفض المستوى المؤجّل: `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 كما كنت تفعل من قبل.