إذا أرسل تطبيقك طلب بيانات من واجهة Play Age Signals API وتعذّر تنفيذ الطلب، سيتلقّى تطبيقك رمز خطأ. يمكن أن تحدث هذه الأخطاء لأسباب مختلفة، مثل أن يكون تطبيق "متجر Play" قديمًا.
استراتيجية إعادة المحاولة: في الحالات التي يكون فيها المستخدم في جلسة، ننصحك بـ تنفيذ استراتيجية إعادة محاولة مع حدّ أقصى لعدد المحاولات كشرط للخروج، وذلك لتقليل تأثير الخطأ على تجربة المستخدم قدر الإمكان.
يتضمّن الجدول التالي رموز الخطأ في واجهة Play Age Signals API.
| الرمز | ثابت | الوصف | إمكانية إعادة المحاولة |
|---|---|---|---|
| -1 | API_NOT_AVAILABLE | واجهة Play Age Signals API غير متاحة. قد يكون إصدار تطبيق "متجر Play" المثبّت على الجهاز قديمًا. اطلب من المستخدم تحديث "متجر Play". | نعم |
| -2 | PLAY_STORE_NOT_FOUND | لم يتم العثور على أي تطبيق "متجر Play" على الجهاز. اطلب من المستخدم تثبيت "متجر Play" أو تفعيله. | نعم |
| -3 | NETWORK_ERROR | لم يتم العثور على أي شبكة متاحة. اطلب من المستخدم التحقّق من وجود اتصال. | نعم |
| -4 | PLAY_SERVICES_NOT_FOUND | خدمات Play غير متاحة أو أنّ إصدارها قديم جدًا. اطلب من المستخدم تثبيت "خدمات Play" أو تحديثها أو تفعيلها. | نعم |
| -5 | CANNOT_BIND_TO_SERVICE | تعذّر الربط بالخدمة في "متجر Play". يمكن أن يرجع ذلك إلى تثبيت إصدار قديم من "متجر Play" على الجهاز أو إلى امتلاء ذاكرة الجهاز. اطلب من المستخدم تحديث تطبيق "متجر Play". أعد المحاولة باستخدام خوارزمية الرقود الأسي الثنائي. | نعم |
| -6 | PLAY_STORE_VERSION_OUTDATED | يجب تحديث تطبيق "متجر Play". اطلب من المستخدم تحديث تطبيق "متجر Play". | نعم |
| -7 | PLAY_SERVICES_VERSION_OUTDATED | يجب تحديث "خدمات Play". اطلب من المستخدم تحديث "خدمات Play". | نعم |
| -8 | CLIENT_TRANSIENT_ERROR | حدث خطأ مؤقت في جهاز العميل. نفِّذ استراتيجية إعادة محاولة مع حدّ أقصى لعدد المحاولات كشرط للخروج. إذا استمرت المشكلة، اطلب من المستخدم المحاولة مرة أخرى لاحقًا. | نعم |
| -9 | APP_NOT_OWNED | لم يتم تثبيت التطبيق من خلال Google Play. اطلب من المستخدم الحصول على تطبيقك من Google Play. | لا |
| -10 | SDK_VERSION_OUTDATED | لم يعُد إصدار حزمة Play Age Signals SDK متاحًا. اطلب من المستخدم تحديث تطبيقك إلى إصدار أحدث يستخدم إصدارًا حديثًا من حزمة Play Age Signals SDK. | لا |
| -100 | INTERNAL_ERROR | خطأ داخلي غير معروف. نفِّذ استراتيجية إعادة محاولة مع حدّ أقصى لعدد المحاولات كشرط للخروج. إذا استمرت المشكلة، اطلب من المستخدم المحاولة مرة أخرى لاحقًا. إذا استمرت المشكلة، تواصَل مع فريق دعم المطوّرين على Google Play، وضِّمن عبارة "واجهة Play Age Signals API" في الموضوع، وأدرِج أكبر قدر ممكن من التفاصيل الفنية (مثل تقرير عن الخطأ). | لا |