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

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

‫27 يناير 2026

الميزات الجديدة

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

• OfferPhase: يتوفّر الحقل OfferPhase الآن في واجهة برمجة التطبيقات SubscriptionPurchaseV2. يوفّر هذا الحقل مرحلة العرض الترويجي الحالية للاشتراك، وهي إحدى المراحل التالية: الفترة النسبية أو الفترة التجريبية المجانية أو السعر التمهيدي أو سعر الخطة الأساسية.

‫19 نوفمبر 2025

الميزات الجديدة

• التعامل المحسّن مع إعادة الاشتراك:

  • يتوفّر الحقل outOfAppPurchaseContext الآن في SubscriptionPurchaseV2، ما يساعد في ربط عمليات شراء إعادة الاشتراك التي تم إجراؤها من "متجر Play" من خلال تقديم تفاصيل من الاشتراك المنتهي.
  • تقبل الطريقة purchases.subscriptions.acknowledge الآن externalAccountId اختيارية في نص الطلب، ما يتيح لك ربط عملية شراء إعادة الاشتراك بمعرّفات المستخدمين.

• يتوفّر الحقل SubscriptionPurchaseLineItem.itemReplacement الآن في SubscriptionPurchaseV2، الذي يقدّم تفاصيل حول السلعة التي سيتم استبدالها، إذا كان ذلك منطبقًا.

• يتضمّن Orders API الآن الحقل offerPhaseDetails الذي يقدّم معلومات أكثر تفصيلاً عن الطلبات التي تموّل فترة نسبية.

• لا تتوفّر هذه الميزات الجديدة حاليًا إلا من خلال واجهات برمجة التطبيقات وليس من خلال مكتبات البرامج.

‫11 سبتمبر 2025

الميزات الجديدة

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

  توفّر هذه الطريقة تحسينًا على وظيفة purchases.subscriptions.cancel الحالية من خلال توفير إمكانية استخدام المَعلمة cancellationType في مكتبات البرامج.

• تتوفّر ميزات الموافقة على زيادة السعر في ما يلي:

  • تمت إضافة حقل جديد في SubscriptionPurchaseV2: SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details.

  • يتوفّر نوع جديد من الإشعارات في الوقت الفعلي الخاصة بالمطوّرين SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED.

‫30 يونيو 2025

الميزات الجديدة

• تتوفّر الآن واجهة برمجة التطبيقات الجديدة ProductPurchaseV2 التي تتيح خيارات شراء متعددة وعروضًا ترويجية للمنتجات التي يتم تحصيل سعرها مرة واحدة.

‫21 مايو 2025

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

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

الميزات الجديدة

• تتوفّر الحقول الجديدة التالية في SubscriptionPurchaseV2:

  • SubscriptionPurchaseLineItem.latest_successful_order_id
  • PriceChangeState.CANCELED

• توفّر الطريقة subscriptionsv2.revoke الآن الخيار item_based_refund.

• توفّر واجهة برمجة التطبيقات Orders الآن الطريقتَين get وbatchGet.

تغييرات أخرى

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