أصبحت Play Billing Library 8 إلزامية لكل تحديث على Google Play، وهي تنقل تتبّع المبالغ المستردة إلى خادمك
انتهت مهلة Google الإضافية لـ Play Billing Library 7 في 1 نوفمبر 2026، لذا تحتاج التطبيقات الجديدة والتحديثات الآن إلى الإصدار 8 أو أحدث. أزال الإصدار 8 الدالة queryPurchaseHistory()، ما يعني أن المشتريات المستردة والمستهلكة يجب تتبّعها على الخادم. إليك ما تغيّر وكم يكلّف الترحيل البطيء.

أهم الخلاصات
- حدّد جدول الإيقاف لدى Google يوم 31 أغسطس 2026 آخر يوم للتطبيقات الجديدة والتحديثات على Play Billing Library 7، وانتهت المهل الإضافية في 1 نوفمبر 2026، لذا يحتاج أي تحديث على Google Play الآن إلى Play Billing Library 8 أو أحدث.
- التطبيقات المنشورة أصلًا على Play Billing Library 7 تستمر في العمل، لأن Google تقول إن الإيقاف يمنع التطبيقات الجديدة والتحديثات فقط، ولا يمسّ عمليات التثبيت الحالية.
- أزالت Play Billing Library 8 الدالة queryPurchaseHistory()، وبديل Google يعمل على الخادم: تتبّع المشتريات المستهلكة على خادمك الخلفي، واجلب المشتريات المستردة أو الملغاة من Voided Purchases API.
- لا تعرض Voided Purchases API في Google Play إلا المشتريات الملغاة خلال آخر 30 يومًا، وتسمح بـ 6,000 استعلام يوميًا و30 استعلامًا في أي فترة مدتها 30 ثانية لكل تطبيق.
- ما زالت Google Play تردّ مبلغ الشراء تلقائيًا وتسحب الاستحقاق إذا لم يؤكد التطبيق الشراء خلال ثلاثة أيام، وقد يتسبب ترحيل معطوب إلى Play Billing Library 8 في ذلك مع كل عملية بيع.
- مراجعة رد المبالغ المتنازع عليها في Google Play هي مسار الاسترداد الوحيد في Android الذي يطلب أدلة من المطوّر، عبر orders.reviewrefund خلال 24 ساعة من PendingRefundReviewNotification.
- بالنسبة لطلبات Google Play التي أُنشئت بعد 3 أغسطس 2026، يدفع المطوّر سعر الشراء، مخصومًا منه رسوم خدمة Play، إضافة إلى رسوم النزاع المصرفية عن كل نزاع يخسره.
يجب على كل تطبيق Android يبيع عبر Google Play أن يشحن الآن Play Billing Library 8 أو أحدث مع تحديثه القادم. كان الموعد النهائي للإصدار 7 للتطبيقات الجديدة والتحديثات هو 31 أغسطس 2026، وانتهت آخر المهل الإضافية في 1 نوفمبر 2026. توجد هذه التواريخ في جدول ضمن الأسئلة الشائعة عن الإيقاف لدى Google، وتصل التذكيرات على شكل تحذيرات في صفحة Policy status في Play Console.
بالنسبة لمعظم الفرق، الأمر مجرد ترقية للاعتمادية وبضع دوال بأسماء جديدة. أما في المبالغ المستردة، فالأمر أكبر من ذلك. حذفت Play Billing Library 8 الاستدعاء الوحيد من جهة العميل الذي كان يتيح للتطبيق مراجعة المشتريات السابقة. من الآن فصاعدًا، إن أردت معرفة ما اشتراه المستخدم أو استهلكه أو استردّ ثمنه، فعلى خادمك أن يتذكّر ذلك.
ما الذي يمنعه موعد Play Billing Library 8 فعلًا
تمنح Google كل إصدار من المكتبة عمرًا مدته سنتان. الإيقاف يمنع التطبيقات الجديدة والتحديثات فقط. تقول الأسئلة الشائعة لدى Google إن التطبيقات الحالية تستمر في العمل، وإن ملفات APK غير المُصانة لا تحتاج إلى تحديث. لذا لا شيء يتعطل اليوم في تطبيق توقفت عن العمل عليه. يتعطل في اليوم الذي تحاول فيه شحن إصلاح أو سعر جديد أو جدار دفع جديد.
| إصدار المكتبة | موعد التطبيقات الجديدة والتحديثات | موعد انتهاء المهلة الإضافية |
|---|---|---|
| 6 | 31 أغسطس 2025 | 1 نوفمبر 2025 |
| 7 | 31 أغسطس 2026 | 1 نوفمبر 2026 |
| 8 | 31 أغسطس 2027 | 1 نوفمبر 2027 |
| 9 | 31 أغسطس 2028 | 1 نوفمبر 2028 |
صدر الإصدار 8.0.0 في 30 يونيو 2025. وتبعه الإصدار 9.0.0 في 19 مايو 2026. إن كنت تُرحّل الآن، فالانتقال مباشرة إلى 9 يمنحك سنة إضافية مقارنة بالتوقف عند 8.
لماذا تهمّ Play Billing Library 8 في المبالغ المستردة
أبرز ما أُزيل هو queryPurchaseHistory(). أُعلن إيقافها في الإصدار 7 وأُزيلت في الإصدار 8.0.0. تقسّم ملاحظات الترحيل لدى Google وظيفتها القديمة إلى ثلاثة أجزاء، ولا يبقى على الجهاز إلا جزء واحد منها.
| ما كنت تستخدم queryPurchaseHistory() من أجله | ما تقول Google باستخدامه الآن | أين يعمل |
|---|---|---|
| المشتريات النشطة والمعلّقة | queryPurchasesAsync() | على الجهاز |
| المشتريات لمرة واحدة المستهلكة | سجلاتك الخاصة | خادمك |
| المشتريات المستردة أو الملغاة أو المتنازع عليها | Voided Purchases API | خادمك |
| سجل المشتريات الكامل للمستخدم | سجلاتك الخاصة | خادمك |
هل ما زال بإمكاني استعادة المشتريات القابلة للاستهلاك على Android؟
ليس من جهة العميل. تعيد queryPurchasesAsync() ما هو نشط فقط، لذا فإن حزمة رصيد مستهلكة أو حزمة جواهر نفدت لن تعود عبرها أبدًا. إن أعاد مستخدم تثبيت التطبيق وسأل أين ذهبت عملاته، فالجواب يجب أن يأتي من السجل الذي احتفظت به عند حدوث الشراء. التطبيقات التي اعتمدت على سجل المشتريات كنسخة احتياطية مجانية فقدتها.
كيف أعرف بالمبالغ المستردة الآن؟
عبر قناتين على الخادم. ترسل إشعارات المطوّر الفورية VoidedPurchaseNotification تحتوي على رمز الشراء ومعرّف الطلب ونوع المنتج ونوع الاسترداد، وهو إما استرداد كامل أو استرداد جزئي حسب الكمية. وتتيح لك Voided Purchases API سحب الأحداث نفسها حسب نطاق زمني، كخط دفاع احتياطي لأي شيء فاتك.
لواجهة السحب هذه حدود صارمة. لا تعرض إلا المشتريات الملغاة خلال آخر 30 يومًا. يحصل كل تطبيق على 6,000 استعلام يوميًا و30 استعلامًا في أي فترة مدتها 30 ثانية. والاسترداد الذي يجريه المطوّر دون خيار السحب لا يُعاد إطلاقًا. الخادم المتوقف لخمسة أسابيع يفقد مبالغ مستردة لن يتمكن من سحبها أبدًا.

في أي المبالغ المستردة ما زال للمطوّر رأي
نقل تتبّع المبالغ المستردة إلى الخادم لا يمنحك سيطرة أكبر عليها. تُحسم تقريبًا كل عمليات الاسترداد في Google Play من دونك: الاسترداد الذاتي، والاسترداد عبر الدعم، والإلغاءات، والاسترداد التلقائي للمشتريات غير المؤكدة. تعلم بها بعد وقوعها، عبر إشعار الشراء الملغى.
الاستثناء هو مراجعة النزاع المصرفي. عندما يرفع مشترٍ نزاعًا يحتاج إلى رأيك، ترسل Google PendingRefundReviewNotification. تقول Google إن عليك الرد باقتراح بشأن الاسترداد وأدلة على الاستخدام خلال 24 ساعة باستدعاء orders.reviewrefund. هذه الأدلة تأتي من سجلات الخادم نفسها التي تُلزمك المكتبة الجديدة بالاحتفاظ بها. الفريق الذي يحتفظ بسجل للاستعادة يملك أصلًا ما يحتاجه للرد.
كم يكلّف الترحيل البطيء من المال
الخطر المباشر هو قاعدة الأيام الثلاثة. تردّ Google Play مبلغ الشراء تلقائيًا وتسحب الاستحقاق إذا لم يؤكد تطبيقك الشراء خلال ثلاثة أيام. في المشتريات المعلّقة، يبدأ العدّ عندما ينتقل الشراء من PENDING إلى PURCHASED. الترحيل الذي يعطّل منطق الاتصال، أو مستمع queryProductDetailsAsync() الجديد، أو إعداد المشتريات المعلّقة، قد يوقف التأكيدات دون أن يوقف المبيعات. كل طلب في تلك الفجوة يُستردّ بالكامل، وقد حصل المستخدم بالفعل على ما دفع ثمنه.
وهنا يكمن الألم. حزمة رصيد الصور المستردة استهلكت بالفعل وقت GPU وراء كل عملية توليد. خطة الذكاء الاصطناعي المستردة شغّلت بالفعل استدعاءات API المدفوعة. فئة التخزين المستردة ملأت بالفعل الأقراص التي تدفع ثمنها. والإكرامية المستردة ذهبت بالفعل في دفعة لأحد صنّاع المحتوى. يعيد الاسترداد الإيراد إلى المشتري ويترك هذه الفواتير عليك.
وأصبحت النزاعات المصرفية أغلى أيضًا. يقول مركز المساعدة لدى Google إنه بالنسبة للطلبات التي أُنشئت بعد 3 أغسطس 2026، يتحمّل المطوّر سعر الشراء، مخصومًا منه رسوم خدمة Play، إضافة إلى رسوم النزاع من البنك. وتواصل Google دفع رسوم خدمتها فقط. التطبيق الذي لا يستطيع الرد على مراجعة النزاع خلال 24 ساعة ببيانات استخدام حقيقية يدفع الفاتورة كاملة في كل مرة.
قائمة تحقق للترحيل تحمي إيراداتك
- رقِّ الاعتمادية إلى Play Billing Library 8 أو 9، واحذف
queryPurchaseHistory()وquerySkuDetailsAsync()وenablePendingPurchases()التي بلا وسيطات. - حدّث مستمع
queryProductDetailsAsync(). منذ الإصدار 8 يعيد أيضًا المنتجات التي تعذّر جلبها، مع رمز حالة. - فعّل
enableAutoServiceReconnection()حتى لا يؤدي انقطاع اتصال الفوترة إلى تعطيل معالجة المشتريات. - استدعِ
queryPurchasesAsync()فيonResume()حتى تُؤكَّد المشتريات التي تكتمل والتطبيق مغلق خلال ثلاثة أيام. - سجّل كل رمز شراء ومعرّف طلب وعملية استهلاك على خادمك، مربوطة بمعرّف الحساب الخاص بك.
- اشترك في إشعارات المطوّر الفورية وعالج كلًّا من
VoidedPurchaseNotificationوPendingRefundReviewNotification. - شغّل مزامنة يومية مع Voided Purchases API كشبكة أمان، ضمن نافذة الثلاثين يومًا وحصة 6,000 استعلام اليومية بهامش واسع.
تستمع RefundHalt إلى إشعارات Google Play الخاصة بالمشتريات الملغاة ومراجعات النزاع، وتردّ على كل مراجعة عبر orders.reviewrefund ضمن نافذة الـ 24 ساعة ببيانات استخدامك الحقيقية، وتحتفظ بسجل المبالغ المستردة الذي لم يعد بإمكان تطبيقك طلبه من الجهاز.
الأسئلة الشائعة
- هل يجب أن أستخدم Play Billing Library 8 الآن؟
- نعم، لأي تطبيق جديد أو تحديث يبيع عبر نظام الفوترة في Google Play. حدّد جدول الإيقاف لدى Google يوم 31 أغسطس 2026 موعدًا نهائيًا للإصدار 7، وانتهت المهل الإضافية في 1 نوفمبر 2026. يمكنك استخدام الإصدار 8 أو الإصدار 9 الأحدث.
- هل سيتوقف تطبيقي الحالي عن العمل إن كان لا يزال يستخدم Play Billing Library 7؟
- لا. تقول Google إن التطبيقات الحالية تستمر في العمل، وإن ملفات APK غير المُصانة لا تحتاج إلى تحديث. الإيقاف يمنعك فقط من نشر تطبيق جديد أو تحديث يستخدم إصدارًا غير مدعوم.
- ما الذي حلّ محل queryPurchaseHistoryAsync في Play Billing Library 8؟
- لا شيء على الجهاز يؤدي الوظيفة نفسها. تقول Google باستخدام queryPurchasesAsync() للمشتريات النشطة والمعلّقة، وتتبّع المشتريات المستهلكة على خادمك، واستخدام Voided Purchases API للمشتريات الملغاة أو المستردة.
- إلى أي مدى زمني تعود Voided Purchases API في Google Play؟
- 30 يومًا. تقول Google إن الواجهة لا تعرض إلا المشتريات الملغاة التي حدثت خلال آخر 30 يومًا، وتحدّ كل تطبيق بـ 6,000 استعلام يوميًا و30 استعلامًا في أي فترة مدتها 30 ثانية.
- هل تردّ Google Play مبلغ الشراء إذا لم يؤكده تطبيقي؟
- نعم. إذا لم يُؤكَّد الشراء خلال ثلاثة أيام، يحصل المستخدم تلقائيًا على استرداد وتسحب Google Play الشراء. في المشتريات المعلّقة، تبدأ الأيام الثلاثة عندما تتغير الحالة من PENDING إلى PURCHASED.
المصادر وقراءات إضافية
- Android Developers: Play Billing Library deprecation FAQ
- Android Developers: Play Billing Library release notes
- Android Developers: Migrate to Play Billing Library 8
- Android Developers: Query purchase history alternatives
- Android Developers: Integrate the Google Play Billing Library into your app
- Android Developers: Real-time developer notifications reference
- Google Play Developer API: Voided Purchases API
- Play Console Help: Chargeback cost sharing for orders after August 3, 2026
RefundHalt
الطيار الآلي للاستردادات في App Store وGoogle Play
تابع القراءة
البرازيل تتحقق الآن من الألعاب التي ما زالت تبيع صناديق الغنائم للأطفال، واسترداد صناديق الغنائم هو حيث تقع الفاتورة
طلبت وزارة العدل البرازيلية من هيئة حماية البيانات مراقبة ست ألعاب تبيع صناديق الغنائم دون التحقق من العمر. إليك ما يشترطه القانون، وما تطلبه Apple وGoogle بالفعل، وكيف تقدّر تكلفة طلبات استرداد صناديق الغنائم وتتعامل معها حين يكون الصندوق قد فُتح بالفعل.
عمليات الشراء العرضية داخل التطبيق هي استردادات لا يمكنك كسبها، لذا فالحل مكانه شاشة الشراء لديك
تعود عمليات الشراء العرضية داخل التطبيق في صورة استردادات على كلا المتجرين، ولا يوجد دليل استخدام يثبت أن النقرة كانت مقصودة. إليك كيف تصنّفها Apple وGoogle، وما تكلّفك كل واحدة منها في الحوسبة والمدفوعات، وتصميم شاشة الشراء الذي يوقفها قبل أن يوجد الخصم أصلًا.