IntegrityErrorCode

public annotation IntegrityErrorCode

קודי שגיאה של Integrity API.

סיכום

ערכים קבועים
static final int

‫Integrity API לא זמין.
static final int

אפליקציית השיחות לא מותקנת.
static final int

המזהה הייחודי (UID) של האפליקציה לשיחות (מזהה המשתמש) לא תואם לזה של מנהל החבילות.
static final int

הקישור לשירות בחנות Play נכשל.
static final int

אירעה שגיאה זמנית במכשיר הלקוח.
static final int

מספר הפרויקט בענן שסיפקת לא תקין.
static final int

שגיאה פנימית לא ידועה בשרת של Google.
static final int

שגיאה פנימית לא ידועה.
static final int

לא נמצאה רשת זמינה.
static final int

הצופן החד-פעמי (nonce) לא מקודד כמחרוזת base64 בטוחה לשימוש באינטרנט ללא גלישת שורות.
static final int

הצופן החד-פעמי (nonce) ארוך מדי.
static final int

אורך הצופן החד-פעמי (nonce) קצר מדי.
static final int
static final int

‫Play Services לא זמין או שהגרסה שלו ישנה מדי.
static final int

צריך לעדכן את שירותי Play.
static final int

לא נמצא חשבון בחנות Play במכשיר.
static final int

לא נמצאה אפליקציה של חנות Play במכשיר או שהותקנה גרסה לא רשמית.
static final int

צריך לעדכן את חנות Play.
static final int

האפליקציה ששולחת את הקריאה שלחה יותר מדי בקשות ל-API והמהירות שלה הוגבלה, או שהאפליקציה חרגה ממכסת הבקשות היומית שלה.

ערכים קבועים

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

המזהה הייחודי (UID) של האפליקציה לשיחות (מזהה המשתמש) לא תואם לזה של מנהל החבילות.

משהו לא בסדר (יכול להיות שמדובר במתקפה). ללא אפשרות לפעולה.

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

אירעה שגיאה זמנית במכשיר הלקוח.

צריך לנסות שוב עם השהיה מעריכית לפני ניסיון חוזר (exponential backoff).

הושק ב-Play Core Integrity בגרסה 1.1.0 (בגרסאות קודמות הוחזר טוקן עם קביעת תקינות ריקה של המכשיר). אם השגיאה נמשכת אחרי כמה ניסיונות חוזרים, צריך להניח שהמכשיר לא עבר את בדיקות התקינות ולפעול בהתאם.

CLOUD_PROJECT_NUMBER_IS_INVALID

public static final int CLOUD_PROJECT_NUMBER_IS_INVALID = -16

מספר הפרויקט בענן שסיפקת לא תקין.

משתמשים במספר הפרויקט ב-Cloud שאפשר למצוא בפרטי הפרויקט ב-Google Cloud Console עבור הפרויקט ב-Cloud שבו מופעל Play Integrity API.

GOOGLE_SERVER_UNAVAILABLE

public static final int GOOGLE_SERVER_UNAVAILABLE = -12

שגיאה פנימית לא ידועה בשרת של Google.

צריך לנסות שוב עם השהיה מעריכית לפני ניסיון חוזר (exponential backoff). אם הפעולה נכשלת באופן עקבי, כדאי לדווח על באג.

INTERNAL_ERROR

public static final int INTERNAL_ERROR = -100

שגיאה פנימית לא ידועה.

צריך לנסות שוב עם השהיה מעריכית לפני ניסיון חוזר (exponential backoff). אם הפעולה נכשלת באופן עקבי, כדאי לדווח על באג.

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

הצופן החד-פעמי (nonce) לא מקודד כמחרוזת base64 בטוחה לשימוש באינטרנט ללא גלישת שורות.

צריך לנסות שוב עם פורמט nonce נכון.

NONCE_TOO_LONG

public static final int NONCE_TOO_LONG = -11

הצופן החד-פעמי (nonce) ארוך מדי. ה-nonce צריך להיות קטן מ-500 בייט לפני קידוד base64.

אפשר לנסות שוב עם nonce קצר יותר.

NONCE_TOO_SHORT

public static final int NONCE_TOO_SHORT = -10

אורך הצופן החד-פעמי (nonce) קצר מדי. כדי לשפר את האבטחה, ה-nonce צריך להיות באורך של 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 Services לא זמין או שהגרסה שלו ישנה מדי.

פעולות מומלצות:

  • מבקשים מהמשתמש להתקין או לעדכן את Play Services.
  • כדי להציג למשתמש חוויית שימוש מודרכת שתעזור לו להפעיל, להתקין או לעדכן את Play Services, אפשר להציג את תיבת הדו-שיח GET_INTEGRITY או GET_STRONG_INTEGRITY.

PLAY_SERVICES_VERSION_OUTDATED

public static final int PLAY_SERVICES_VERSION_OUTDATED = -15

צריך לעדכן את שירותי Play.

פעולות מומלצות:

  • מבקשים מהמשתמש לעדכן את Google Play Services.
  • כדי לספק למשתמש חוויה מודרכת שתעזור לו לעדכן את שירותי 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

האפליקציה ששולחת את הקריאה שלחה יותר מדי בקשות ל-API והמהירות שלה הוגבלה, או שהאפליקציה חרגה ממכסת הבקשות היומית שלה.

צריך לנסות שוב עם השהיה מעריכית לפני ניסיון חוזר (exponential backoff). אם הגעתם למגבלת הבקשות היומית, אתם יכולים לשלוח בקשה להגדלת מכסת הבקשות היומית.