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