ملاحظات حول إصدار واجهة برمجة التطبيقات Google Play Developer API

يحتوي هذا المستند على ملاحظات الإصدار الخاصة بواجهات Google Play Developer API.

‫27 يناير 2026

تأجيل الاشتراك مع حِزم إضافية: في السابق، كانت واجهة Google Play Developer API تتيح تأجيل الفوترة للاشتراكات الفردية فقط. تتوفّر وظيفة تأجيل الدفع الآن لكل من الاشتراكات الفردية والاشتراكات التي تتضمّن إضافات من خلال طريقة الدفع purchases.subscriptionsv2.defer. عند تأجيل تاريخ فوترة اشتراك يتضمّن ميزات إضافية، يتم تأجيل تاريخ فوترة جميع العناصر في الاشتراك لمدة التأجيل المحدّدة.
OfferPhase: يتوفّر الحقل OfferPhase الآن في واجهة برمجة التطبيقات SubscriptionPurchaseV2. يعرض هذا الحقل مرحلة العرض الترويجي الحالية للاشتراك، وهي إحدى المراحل التالية: فترة نسبية، أو فترة تجريبية مجانية، أو سعر تمهيدي، أو سعر الخطة الأساسية.

تحسين عملية إعادة الاشتراك:
- يتوفّر الحقل outOfAppPurchaseContext الآن في SubscriptionPurchaseV2، ما يساعد في ربط عمليات شراء إعادة الاشتراك التي تتم من "متجر Play" من خلال تقديم تفاصيل من الاشتراك المنتهي.
- يقبل الآن الإجراء purchases.subscriptions.acknowledge المَعلمة الاختيارية externalAccountId في نص الطلب، ما يتيح لك ربط عملية إعادة الاشتراك بمعرّفات المستخدمين.
يتوفّر الحقل SubscriptionPurchaseLineItem.itemReplacement الآن في SubscriptionPurchaseV2، الذي يقدّم تفاصيل حول السلعة التي سيتم استبدالها، إذا كان ذلك منطبقًا.
يتضمّن Orders API الآن الحقل offerPhaseDetails الذي يقدّم معلومات أكثر تفصيلاً عن الطلبات التي تموّل فترة نسبية.

توفّر واجهة برمجة التطبيقات SubscriptionPurchaseV2 الآن الطريقة cancel.

توفّر هذه الطريقة تحسينًا على وظيفة purchases.subscriptions.cancel الحالية من خلال توفير دعم للمَعلمة cancellationType في مكتبات البرامج.
تتوفّر ميزات الموافقة على زيادة السعر في الحالات التالية:
- تمت إضافة حقل جديد في SubscriptionPurchaseV2: SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details.
- يتوفّر نوع جديد من الإشعارات في الوقت الفعلي الخاصة بالمطوّرين SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED.

تم إيقاف بعض واجهات برمجة التطبيقات الخاصة بالاشتراكات نهائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إيقاف واجهة برمجة التطبيقات Subscription API نهائيًا.

تتوفّر الحقول الجديدة التالية في SubscriptionPurchaseV2:
- SubscriptionPurchaseLineItem.latest_successful_order_id
- PriceChangeState.CANCELED
توفّر الطريقة subscriptionsv2.revoke الآن الخيار item_based_refund.
توفّر واجهة برمجة التطبيقات Orders الآن الطريقتَين get وbatchGet.

المَعلمة subscriptionId اختيارية في واجهات برمجة التطبيقات purchases.subscriptions.