السماح لخدمة Play بحلّ مشاكل السلامة نيابةً عنك: عرض طلب واحد داخل التطبيق من Play لحلّ مجموعة كبيرة من المشاكل المتعلّقة بنتائج التحقّق والأخطاء من جهة العميل باستخدام مربّعات الحوار المخصَّصة لتصدير البيانات الناقصة في Play، يمكنك إعادة المزيد من المستخدمين إلى حالة جيدة وتسهيل عملية دمج واجهة برمجة التطبيقات. مزيد من المعلومات

IntegrityErrorCode

public annotation IntegrityErrorCode

رموز الخطأ في واجهة برمجة التطبيقات Integrity API

ملخّص

الثوابت
`static final int`	`API_NOT_AVAILABLE = -1` واجهة برمجة التطبيقات Integrity API غير متاحة.
`static final int`	`APP_NOT_INSTALLED = -5` لم يتم تثبيت تطبيق الاتصال.
`static final int`	`APP_UID_MISMATCH = -7` لا يتطابق المعرّف الفريد للتطبيق (معرّف المستخدم) الذي يتم الاتصال به مع المعرّف الفريد من "مدير الحِزم".
`static final int`	`CANNOT_BIND_TO_SERVICE = -9` تعذّر الربط بالخدمة في "متجر Play".
`static final int`	`CLIENT_TRANSIENT_ERROR = -17` حدث خطأ عابر في جهاز العميل.
`static final int`	`CLOUD_PROJECT_NUMBER_IS_INVALID = -16` رقم المشروع على السحابة الإلكترونية المقدَّم غير صالح.
`static final int`	`GOOGLE_SERVER_UNAVAILABLE = -12` حدث خطأ غير معروف في خادم Google الداخلي.
`static final int`	`INTERNAL_ERROR = -100` حدث خطأ داخلي غير معروف.
`static final int`	`NETWORK_ERROR = -3` لم يتم العثور على أي شبكة متاحة.
`static final int`	`NONCE_IS_NOT_BASE64 = -13` لم يتم ترميز الرقم الخاص كسلسلة base64 آمنة على الويب بدون التفاف.
`static final int`	`NONCE_TOO_LONG = -11` طول الرقم الخاص طويل جدًا.
`static final int`	`NONCE_TOO_SHORT = -10` طول الرقم الخاص قصير جدًا.
`static final int`	`NO_ERROR = 0`
`static final int`	`PLAY_SERVICES_NOT_FOUND = -6` "خدمات Play" غير متاحة أو الإصدار قديم جدًا.
`static final int`	`PLAY_SERVICES_VERSION_OUTDATED = -15` يجب تحديث "خدمات Play".
`static final int`	`PLAY_STORE_ACCOUNT_NOT_FOUND = -4` لم يتم العثور على حساب على "متجر Play" على الجهاز.
`static final int`	`PLAY_STORE_NOT_FOUND = -2` لم يتم العثور على تطبيق "متجر Play" على الجهاز أو تم تثبيت إصدار غير رسمي.
`static final int`	`PLAY_STORE_VERSION_OUTDATED = -14` يجب تحديث "متجر Play".
`static final int`	`TOO_MANY_REQUESTS = -8` أرسل تطبيق الاتصال عددًا كبيرًا جدًا من الطلبات إلى واجهة برمجة التطبيقات وتم تقييده، أو تجاوز تطبيقك الحصة اليومية المخصّصة للطلبات.

الثوابت

API_NOT_AVAILABLE

public static final int API_NOT_AVAILABLE = -1

واجهة برمجة التطبيقات Integrity API غير متاحة.

لم يتم تفعيل Integrity API، أو قد يكون إصدار "متجر Play" قديمًا.

الإجراءات المُقترَحة:

تأكَّد من تفعيل Integrity API في Google Play Console.
اطلب من المستخدم تحديث "متجر Play".

APP_NOT_INSTALLED

public static final int APP_NOT_INSTALLED = -5

لم يتم تثبيت تطبيق الاتصال.

حدث خطأ (من المحتمل أن يكون هجومًا). غير قابل للاستخدام

APP_UID_MISMATCH

public static final int APP_UID_MISMATCH = -7

لا يتطابق المعرّف الفريد للتطبيق (معرّف المستخدم) الذي يتم الاتصال به مع المعرّف الفريد من "مدير الحِزم".

حدث خطأ (من المحتمل أن يكون هجومًا). غير قابل للاستخدام

CANNOT_BIND_TO_SERVICE

public static final int CANNOT_BIND_TO_SERVICE = -9

تعذّر الربط بالخدمة في "متجر Play". قد يرجع ذلك إلى تثبيت إصدار قديم من "متجر Play" على الجهاز.

اطلب من المستخدم تحديث "متجر Play".

CLIENT_TRANSIENT_ERROR

public static final int CLIENT_TRANSIENT_ERROR = -17

حدث خطأ عابر في جهاز العميل.

أعِد المحاولة باستخدام خوارزمية الرقود الأسي الثنائي.

تم طرح هذه الرموز في الإصدار 1.1.0 من حزمة تطوير البرامج Integrity Play Core (كانت الإصدارات السابقة تعرض رمزًا مميزًا يتضمّن بيان سلامة الجهاز فارغًا). إذا استمر ظهور الخطأ بعد عدة محاولات، عليك افتراض أنّ الجهاز لم يستوفِ متطلبات التحقّق من السلامة والتصرّف وفقًا لذلك.

CLOUD_PROJECT_NUMBER_IS_INVALID

public static final int CLOUD_PROJECT_NUMBER_IS_INVALID = -16

رقم المشروع على السحابة الإلكترونية المقدَّم غير صالح.

استخدِم رقم مشروع السحابة الإلكترونية الذي يمكن العثور عليه في معلومات المشروع في Google Cloud Console لمشروع السحابة الإلكترونية الذي تم تفعيل Play Integrity API فيه.

GOOGLE_SERVER_UNAVAILABLE

public static final int GOOGLE_SERVER_UNAVAILABLE = -12

حدث خطأ غير معروف في خادم Google الداخلي.

أعِد المحاولة باستخدام خوارزمية الرقود الأسي الثنائي. ننصحك بإرسال تقرير بالخطأ إذا تعذّر ذلك باستمرار.

INTERNAL_ERROR

public static final int INTERNAL_ERROR = -100

حدث خطأ داخلي غير معروف.

أعِد المحاولة باستخدام خوارزمية الرقود الأسي الثنائي. ننصحك بإرسال تقرير بالخطأ إذا تعذّر ذلك باستمرار.

NETWORK_ERROR

public static final int NETWORK_ERROR = -3

لم يتم العثور على أي شبكة متاحة.

الإجراءات المُقترَحة:

اطلب من المستخدم التحقّق من اتصال الشبكة وتفعيله.
للحصول على تجربة مستخدم موجّهة تساعد المستخدم في إنشاء اتصال بالشبكة، يمكنك عرض مربّع الحوار GET_INTEGRITY أو GET_STRONG_INTEGRITY.

NONCE_IS_NOT_BASE64

public static final int NONCE_IS_NOT_BASE64 = -13

لم يتم ترميز الرقم الخاص كسلسلة base64 آمنة على الويب بدون التفاف.

يُرجى إعادة المحاولة باستخدام تنسيق nonce الصحيح.

NONCE_TOO_LONG

public static final int NONCE_TOO_LONG = -11

طول الرقم الخاص طويل جدًا. يجب أن يكون حجم الرقم العشوائي أقل من 500 بايت قبل ترميز base64.

أعِد المحاولة باستخدام قيمة nonce أقصر.

NONCE_TOO_SHORT

public static final int NONCE_TOO_SHORT = -10

طول الرقم الخاص قصير جدًا. يجب أن يكون الرقم العشوائي 16 بايت على الأقل (قبل ترميز base64) للسماح بأمان أفضل.

أعِد المحاولة باستخدام قيمة nonce أطول.

NO_ERROR

public static final int NO_ERROR = 0

PLAY_SERVICES_NOT_FOUND

public static final int PLAY_SERVICES_NOT_FOUND = -6

"خدمات Play" غير متاحة أو الإصدار قديم جدًا.

الإجراءات المُقترَحة:

اطلب من المستخدم تثبيت "خدمات Play" أو تحديثها.
للحصول على تجربة مستخدم موجّهة تساعد المستخدم في تفعيل "خدمات Play" أو تثبيتها أو تحديثها، يمكنك عرض مربع الحوار GET_INTEGRITY أو GET_STRONG_INTEGRITY.

PLAY_SERVICES_VERSION_OUTDATED

public static final int PLAY_SERVICES_VERSION_OUTDATED = -15

يجب تحديث "خدمات Play".

الإجراءات المُقترَحة:

اطلب من المستخدم تحديث "خدمات Google Play".
للحصول على تجربة مستخدم موجّهة تساعد المستخدم في تحديث "خدمات Play"، يمكنك عرض مربّع الحوار GET_INTEGRITY أو GET_STRONG_INTEGRITY.

PLAY_STORE_ACCOUNT_NOT_FOUND

public static final int PLAY_STORE_ACCOUNT_NOT_FOUND = -4

لم يتم العثور على حساب على "متجر Play" على الجهاز. يُرجى العِلم أنّ واجهة برمجة التطبيقات Play Integrity API تتيح الآن الطلبات غير المصادَق عليها. يُستخدَم رمز الخطأ هذا فقط مع إصدارات "متجر Play" القديمة التي لا تتوافق مع هذه الميزة.

اطلب من المستخدم إثبات ملكية الحساب في "متجر Play".

PLAY_STORE_NOT_FOUND

public static final int PLAY_STORE_NOT_FOUND = -2

لم يتم العثور على تطبيق "متجر Play" على الجهاز أو تم تثبيت إصدار غير رسمي.

اطلب من المستخدم تثبيت إصدار رسمي وحديث من "متجر Play".

PLAY_STORE_VERSION_OUTDATED

public static final int PLAY_STORE_VERSION_OUTDATED = -14

يجب تحديث "متجر Play".

اطلب من المستخدم تحديث "متجر Google Play".

TOO_MANY_REQUESTS

public static final int TOO_MANY_REQUESTS = -8

أرسل تطبيق الاتصال عددًا كبيرًا جدًا من الطلبات إلى واجهة برمجة التطبيقات وتم تقييده، أو تجاوز تطبيقك الحصة اليومية المخصّصة للطلبات.

أعِد المحاولة باستخدام خوارزمية الرقود الأسي الثنائي. يمكنك طلب زيادة حصة الطلبات اليومية إذا بلغت الحدّ الأقصى المسموح به.