IntegrityErrorCode

public abstract @interface IntegrityErrorCode
implements Annotation

com.google.android.play.core.integrity.model.IntegrityErrorCode


Error codes for Integrity API.

Summary

Constants

int API_NOT_AVAILABLE

Integrity API is not available.

int APP_NOT_INSTALLED

The calling app is not installed.

int APP_UID_MISMATCH

The calling app UID (user id) does not match the one from Package Manager.

int CANNOT_BIND_TO_SERVICE

Binding to the service in the Play Store has failed.

int CLIENT_TRANSIENT_ERROR

There was a transient error in the client device.

int CLOUD_PROJECT_NUMBER_IS_INVALID

The provided cloud project number is invalid.

int GOOGLE_SERVER_UNAVAILABLE

Unknown internal Google server error.

int INTERNAL_ERROR

Unknown internal error.

int NETWORK_ERROR

No available network is found.

int NONCE_IS_NOT_BASE64

Nonce is not encoded as a base64 web-safe no-wrap string.

int NONCE_TOO_LONG

Nonce length is too long.

int NONCE_TOO_SHORT

Nonce length is too short.

int NO_ERROR

int PLAY_SERVICES_NOT_FOUND

Play Services is not available or version is too old.

int PLAY_SERVICES_VERSION_OUTDATED

Play Services needs to be updated.

int PLAY_STORE_ACCOUNT_NOT_FOUND

No Play Store account is found on device.

int PLAY_STORE_NOT_FOUND

No Play Store app is found on device or not official version is installed.

int PLAY_STORE_VERSION_OUTDATED

The Play Store needs to be updated.

int TOO_MANY_REQUESTS

The calling app is making too many requests to the API and hence is throttled.

Inherited methods

Constants

API_NOT_AVAILABLE

public static final int API_NOT_AVAILABLE

Integrity API is not available.

Integrity API is not enabled, or the Play Store version might be old.

    Recommended actions:
  • Make sure that Integrity API is enabled in Google Play Console.
  • Ask the user to update Play Store.

Constant Value: -1 (0xffffffff)

APP_NOT_INSTALLED

public static final int APP_NOT_INSTALLED

The calling app is not installed.

Something is wrong (possibly an attack). Non-actionable.

Constant Value: -5 (0xfffffffb)

APP_UID_MISMATCH

public static final int APP_UID_MISMATCH

The calling app UID (user id) does not match the one from Package Manager.

Something is wrong (possibly an attack). Non-actionable.

Constant Value: -7 (0xfffffff9)

CANNOT_BIND_TO_SERVICE

public static final int CANNOT_BIND_TO_SERVICE

Binding to the service in the Play Store has failed. This can be due to having an old Play Store version installed on the device.

Ask the user to update Play Store.

Constant Value: -9 (0xfffffff7)

CLIENT_TRANSIENT_ERROR

public static final int CLIENT_TRANSIENT_ERROR

There was a transient error in the client device.

Retry with an exponential backoff.

Introduced in Integrity Play Core version 1.1.0 (prior versions returned a token with empty Device Integrity Verdict). If the error persists after a few retries, you should assume that the device has failed integrity checks and act accordingly.

Constant Value: -17 (0xffffffef)

CLOUD_PROJECT_NUMBER_IS_INVALID

public static final int CLOUD_PROJECT_NUMBER_IS_INVALID

The provided cloud project number is invalid.

Use the cloud project number which can be found in Project info in your Google Cloud Console for the cloud project where Play Integrity API is enabled.

Constant Value: -16 (0xfffffff0)

GOOGLE_SERVER_UNAVAILABLE

public static final int GOOGLE_SERVER_UNAVAILABLE

Unknown internal Google server error.

Retry with an exponential backoff. Consider filing a bug if fails consistently.

Constant Value: -12 (0xfffffff4)

INTERNAL_ERROR

public static final int INTERNAL_ERROR

Unknown internal error.

Retry with an exponential backoff. Consider filing a bug if fails consistently.

Constant Value: -100 (0xffffff9c)

NETWORK_ERROR

public static final int NETWORK_ERROR

No available network is found.

Ask the user to check for a connection.

Constant Value: -3 (0xfffffffd)

NONCE_IS_NOT_BASE64

public static final int NONCE_IS_NOT_BASE64

Nonce is not encoded as a base64 web-safe no-wrap string.

Retry with correct nonce format.

Constant Value: -13 (0xfffffff3)

NONCE_TOO_LONG

public static final int NONCE_TOO_LONG

Nonce length is too long. The nonce must be less than 500 bytes before base64 encoding.

Retry with a shorter nonce.

Constant Value: -11 (0xfffffff5)

NONCE_TOO_SHORT

public static final int NONCE_TOO_SHORT

Nonce length is too short. The nonce must be a minimum of 16 bytes (before base64 encoding) to allow for a better security.

Retry with a longer nonce.

Constant Value: -10 (0xfffffff6)

NO_ERROR

public static final int NO_ERROR

Constant Value: 0 (0x00000000)

PLAY_SERVICES_NOT_FOUND

public static final int PLAY_SERVICES_NOT_FOUND

Play Services is not available or version is too old.

Ask the user to Install or Update Play Services.

Constant Value: -6 (0xfffffffa)

PLAY_SERVICES_VERSION_OUTDATED

public static final int PLAY_SERVICES_VERSION_OUTDATED

Play Services needs to be updated.

Ask the user to update Google Play Services.

Constant Value: -15 (0xfffffff1)

PLAY_STORE_ACCOUNT_NOT_FOUND

public static final int PLAY_STORE_ACCOUNT_NOT_FOUND

No Play Store account is found on device. Note that the Play Integrity API now supports unauthenticated requests. This error code is used only for older Play Store versions that lack support.

Ask the user to authenticate in Play Store.

Constant Value: -4 (0xfffffffc)

PLAY_STORE_NOT_FOUND

public static final int PLAY_STORE_NOT_FOUND

No Play Store app is found on device or not official version is installed.

Ask the user to install an official and recent version of Play Store.

Constant Value: -2 (0xfffffffe)

PLAY_STORE_VERSION_OUTDATED

public static final int PLAY_STORE_VERSION_OUTDATED

The Play Store needs to be updated.

Ask the user to update the Google Play Store.

Constant Value: -14 (0xfffffff2)

TOO_MANY_REQUESTS

public static final int TOO_MANY_REQUESTS

The calling app is making too many requests to the API and hence is throttled.

Retry with an exponential backoff.

Constant Value: -8 (0xfffffff8)