StandardIntegrityErrorCode

public annotation StandardIntegrityErrorCode


Error codes for Standard Integrity API.

Summary

Constants

static final int

Standard Integrity API is not available.

static final int

The calling app is not installed.

static final int

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

static final int

Binding to the service in the Play Store has failed.

static final int

There was a transient error in the client device.

static final int

The provided cloud project number is invalid.

static final int

Unknown internal Google server error.

static final int

The StandardIntegrityTokenProvider is invalid (e.g. it is outdated).

static final int

Unknown internal error.

static final int

No available network is found.

static final int
static final int

Play Services is not available or version is too old.

static final int

Play Services needs to be updated.

static final int

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

static final int

The Play Store needs to be updated.

static final int

The provided request hash is too long.

static final int

The calling app has made too many requests to the API and has been throttled, or your app has exceeded its daily request quota.

Constants

API_NOT_AVAILABLE

public static final int API_NOT_AVAILABLE = -1

Standard Integrity API is not available.

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

Recommended actions:

  • Make sure to be allowlisted to use Standard Integrity API.
  • Make sure that Integrity API is enabled in Google Play Console.
  • Ask the user to update Play Store.

APP_NOT_INSTALLED

public static final int APP_NOT_INSTALLED = -5

The calling app is not installed.

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

APP_UID_MISMATCH

public static final int APP_UID_MISMATCH = -7

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

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

CANNOT_BIND_TO_SERVICE

public static final int CANNOT_BIND_TO_SERVICE = -9

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 or device memory is overloaded.

Ask the user to update Play Store.

Retry with an exponential backoff.

CLIENT_TRANSIENT_ERROR

public static final int CLIENT_TRANSIENT_ERROR = -18

There was a transient error in the client device.

Retry with an exponential backoff.

If the error persists after a few retries, you should assume that the device has failed integrity checks and act accordingly.

CLOUD_PROJECT_NUMBER_IS_INVALID

public static final int CLOUD_PROJECT_NUMBER_IS_INVALID = -16

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.

GOOGLE_SERVER_UNAVAILABLE

public static final int GOOGLE_SERVER_UNAVAILABLE = -12

Unknown internal Google server error.

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

INTEGRITY_TOKEN_PROVIDER_INVALID

public static final int INTEGRITY_TOKEN_PROVIDER_INVALID = -19

The StandardIntegrityTokenProvider is invalid (e.g. it is outdated).

This error can be returned only for StandardIntegrityTokenProvider#request(StandardIntegrityTokenRequest).

Request a new integrity token provider by calling StandardIntegrityManager#prepareIntegrityToken(PrepareIntegrityTokenRequest).

INTERNAL_ERROR

public static final int INTERNAL_ERROR = -100

Unknown internal error.

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

NETWORK_ERROR

public static final int NETWORK_ERROR = -3

No available network is found.

Recommended actions:

  • Ask the user to check and enable their network connection.
  • For a guided user experience that helps the user to establish a network connection, you can show either GET_INTEGRITY or GET_STRONG_INTEGRITY dialog.

NO_ERROR

public static final int NO_ERROR = 0

PLAY_SERVICES_NOT_FOUND

public static final int PLAY_SERVICES_NOT_FOUND = -6

Play Services is not available or version is too old.

Recommended actions:

  • Ask the user to Install or Update Play Services.
  • For a guided user experience that helps the user to enable, install or update Play Services, you can show either GET_INTEGRITY or GET_STRONG_INTEGRITY dialog.

PLAY_SERVICES_VERSION_OUTDATED

public static final int PLAY_SERVICES_VERSION_OUTDATED = -15

Play Services needs to be updated.

Recommended actions:

  • Ask the user to update Google Play Services.
  • For a guided user experience that helps the user to update Play Services, you can show either GET_INTEGRITY or GET_STRONG_INTEGRITY dialog.

PLAY_STORE_NOT_FOUND

public static final int PLAY_STORE_NOT_FOUND = -2

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.

PLAY_STORE_VERSION_OUTDATED

public static final int PLAY_STORE_VERSION_OUTDATED = -14

The Play Store needs to be updated.

Ask the user to update the Google Play Store.

REQUEST_HASH_TOO_LONG

public static final int REQUEST_HASH_TOO_LONG = -17

The provided request hash is too long. The request hash length must be less than 500 bytes.

Retry with a shorter request hash.

TOO_MANY_REQUESTS

public static final int TOO_MANY_REQUESTS = -8

The calling app has made too many requests to the API and has been throttled, or your app has exceeded its daily request quota.

Retry with an exponential backoff. Request an increase to your daily request quota if you're at your daily request limit.