IntegrityErrorCode

public annotation IntegrityErrorCode


Integrity API 的錯誤代碼。

摘要

常數

static final int

Integrity API 無法使用。

static final int

未安裝發出呼叫的應用程式。

static final int

發出呼叫的應用程式 UID (使用者 ID) 與套件管理員中的 UID 不符。

static final int

無法與 Play 商店中的服務繫結。

static final int

用戶端裝置發生暫時性錯誤。

static final int

提供的 Cloud 專案編號無效。

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 服務的版本過舊或無法使用。

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 商店版本可能較舊。

建議採取的行動:

  • 確認已在 Google Play 管理中心啟用 Integrity API。
  • 請使用者更新 Play 商店。

APP_NOT_INSTALLED

public static final int APP_NOT_INSTALLED = -5

未安裝發出呼叫的應用程式。

發生問題;有可能是攻擊。無法操作。

APP_UID_MISMATCH

public static final int APP_UID_MISMATCH = -7

發出呼叫的應用程式 UID (使用者 ID) 與套件管理員中的 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

用戶端裝置發生暫時性錯誤。

以指數輪詢方式重試。

在 Integrity Play Core 1.1.0 版中實作 (較舊版本傳回的權杖會是空的裝置完整性判定結果)。如果重試數次後錯誤仍未解決,您應假設裝置未通過完整性檢查,並據此採取行動。

CLOUD_PROJECT_NUMBER_IS_INVALID

public static final int CLOUD_PROJECT_NUMBER_IS_INVALID = -16

提供的 Cloud 專案編號無效。

請在 Google Cloud 控制台的專案資訊中,找出已啟用 Play Integrity API 的 Cloud 專案所適用的 Cloud 專案編號。

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_INTEGRITYGET_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 服務的版本過舊或無法使用。

建議採取的行動:

  • 請使用者安裝或更新 Play 服務。
  • 如要提供引導式使用者體驗,協助使用者啟用、安裝或更新 Play 服務,您可以顯示 GET_INTEGRITYGET_STRONG_INTEGRITY 對話方塊。

PLAY_SERVICES_VERSION_OUTDATED

public static final int PLAY_SERVICES_VERSION_OUTDATED = -15

Play 服務需要更新。

建議採取的行動:

  • 請使用者更新 Google Play 服務。
  • 如要提供引導式使用者體驗,協助使用者更新 Play 服務,您可以顯示 GET_INTEGRITYGET_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 提出的要求過多,已受到限制,或是您的應用程式已超過每日要求配額。

以指數輪詢方式重試。如果已達到每日要求上限,請申請調高每日要求配額。