كل المقالات
تحليل معمّقمدة القراءة 7 دقائق

أصبحت Play Billing Library 8 إلزامية لكل تحديث على Google Play، وهي تنقل تتبّع المبالغ المستردة إلى خادمك

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

مكتب مطوّر Android في ضوء الصباح، عليه حاسوب محمول وهاتف، وعلى الجدار تقويم وُضعت دائرة حول أحد تواريخه، في الأسبوع الذي أصبحت فيه Play Billing Library 8 الحد الأدنى لتحديثات Google Play

أهم الخلاصات

  • حدّد جدول الإيقاف لدى 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 غير المُصانة لا تحتاج إلى تحديث. لذا لا شيء يتعطل اليوم في تطبيق توقفت عن العمل عليه. يتعطل في اليوم الذي تحاول فيه شحن إصلاح أو سعر جديد أو جدار دفع جديد.

إصدار المكتبةموعد التطبيقات الجديدة والتحديثاتموعد انتهاء المهلة الإضافية
631 أغسطس 20251 نوفمبر 2025
731 أغسطس 20261 نوفمبر 2026
831 أغسطس 20271 نوفمبر 2027
931 أغسطس 20281 نوفمبر 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 المستردة والمستهلكة بعد أن أزالت Play Billing Library 8 سجل المشتريات من جهة العميل

في أي المبالغ المستردة ما زال للمطوّر رأي

نقل تتبّع المبالغ المستردة إلى الخادم لا يمنحك سيطرة أكبر عليها. تُحسم تقريبًا كل عمليات الاسترداد في 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.

المصادر وقراءات إضافية

RefundHalt

الطيار الآلي للاستردادات في App Store وGoogle Play

تابع القراءة

طلب الاسترداد التالي في طريقه إليك بالفعل.

أعد RefundHalt في الوقت الذي تستغرقه لقراءة رسالة دعم أخرى عن استرداد لم تتمكن من الاعتراض عليه.