يحتوي هذا المستند على ملاحظات حول إصدارات واجهات Google Play Developer API.
6 يوليو 2026
الميزات الجديدة
تعديلات على المسؤولية عن تكاليف رد المبالغ المدفوعة: تتيح Google Play الآن عملية تعاونية للطعن في رد المبالغ المدفوعة.
الإشعارات بشأن مراجعة طلبات رد الأموال المعلّقة: يتم إرسال نوع جديد من "الإشعارات في الوقت الفعلي الخاصة بالمطوّرين" (RTDN)، وهو
PendingRefundReviewNotification، عندما يطلب أحد المستخدمين رد مبلغ مدفوع يتطلب مراجعتك. لا تتيح المراجعات المعلّقة سوىCHARGEBACKكسبب لرد الأموال.واجهة برمجة التطبيقات ReviewRefund: يمكنك تقييم هذه الطلبات والردّ عليها في غضون 24 ساعة من خلال طلب واجهة برمجة التطبيقات الجديدة
orders.reviewrefund. في طلب البيانات من واجهة برمجة التطبيقات، يجب تقديم خيار رد الأموال (مثلAPPROVEأوDECLINEأوNEUTRAL) وأي دليل ذي صلة على استخدام عملية الشراء (مثل عنوان IP للمستخدم ونسبة الاستهلاك التراكمية والموقع الجغرافي العام) لمساعدة Google Play في الطعن في رد المبلغ المدفوع.
19 مايو 2026
الميزات الجديدة
- مُعرّف الطلب المعلّق: تتضمّن واجهة برمجة التطبيقات SubscriptionPurchaseV2 الآن الحقلَين
onHoldStateContextوinGracePeriodStateContext. يقدّم هذان الحقلان تفاصيل إضافية، مثل مُعرّف الطلب المعلّق أو الذي تعذّر تنفيذه، عندما ينتقل الاشتراك إلى الحالةON_HOLDأوIN_GRACE_PERIODبسبب رفض دفعة التجديد.
الميزات التي سيتم إيقافها نهائيًا
- سيتم إيقاف بعض واجهات برمجة التطبيقات للاشتراكات نهائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إيقاف واجهات برمجة التطبيقات للاشتراكات نهائيًا في مايو 2026.
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.يتوفّر نوع جديد من "الإشعارات في الوقت الفعلي الخاصة بالمطوّرين" (RTDN)، وهو SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED.
30 يونيو 2025
الميزات الجديدة
- تتوفّر واجهة برمجة التطبيقات الجديدة ProductPurchaseV2 التي تتيح خيارات شراء متعددة وعروضًا للمنتجات التي يتم تحصيل سعرها مرة واحدة.
21 مايو 2025
الميزات التي سيتم إيقافها نهائيًا
- سيتم إيقاف بعض واجهات برمجة التطبيقات للاشتراكات نهائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إيقاف واجهات برمجة التطبيقات للاشتراكات نهائيًا.
الميزات الجديدة
تتوفّر الحقول الجديدة التالية في SubscriptionPurchaseV2:
SubscriptionPurchaseLineItem.latest_successful_order_idPriceChangeState.CANCELED
توفر الطريقة
subscriptionsv2.revokeالآن الخيارitem_based_refund.توفر واجهة برمجة التطبيقات Orders الآن الطريقتين
getوbatchGet.
تغييرات أخرى
- المَعلمة subscriptionId اختيارية في واجهات برمجة التطبيقات purchases.subscriptions.