Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

‫19 مايو 2026

مُعرّف الطلب المعلّق: تتضمّن واجهة برمجة التطبيقات SubscriptionPurchaseV2 الآن الحقلَين onHoldStateContext وinGracePeriodStateContext. توفّر هذه الحقول تفاصيل إضافية، مثل معرّف الطلب المعلق أو الذي تعذّر تنفيذه، عندما ينتقل الاشتراك إلى الحالة ON_HOLD أو IN_GRACE_PERIOD بسبب رفض دفعة التجديد.

تم إيقاف بعض واجهات برمجة التطبيقات الخاصة بالاشتراكات نهائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إيقاف واجهة Subscription API نهائيًا في أيار (مايو) 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.

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

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

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