오류 코드

이 페이지에는 일반적인 오류 코드와 오류 코드가 나타내는 내용, 앱이나 게임에서 이에 대응할 수 있는 방식이 나열되어 있습니다.

일반적인 오류 코드

다음 표에는 API가 플랫폼에서 반환할 수 있는 오류와 제안된 후속 조치가 나와 있습니다.

오류 코드 설명 조치
API_NOT_AVAILABLE Integrity API를 사용할 수 없습니다. Play 스토어 버전이 오래되었을 수 있고 또는 애플리케이션이 이 API를 사용하도록 설정되지 않았습니다. 1) 앱이 API를 사용하도록 설정되었는지 확인합니다.
2) 사용자에게 Google Play 스토어를 업데이트하라고 요청합니다.
NETWORK_ERROR 사용 가능한 네트워크를 찾을 수 없습니다. 사용자에게 네트워크 연결을 확인하라고 요청합니다.
PLAY_STORE_NOT_FOUND 기기에서 공식 Play 스토어 앱을 찾을 수 없습니다. 사용자에게 Google Play 스토어를 설치하거나 사용 설정하라고 요청합니다.
PLAY_STORE_VERSION_OUTDATED Play 스토어 앱을 업데이트해야 합니다. 사용자에게 Google Play 스토어를 업데이트하라고 요청합니다.
PLAY_STORE_ACCOUNT_NOT_FOUND 기기에서 Play 스토어 계정을 찾을 수 없습니다. Play Integrity API가 이제 인증되지 않은 요청을 지원합니다. 이 오류 코드는 지원되지 않는 이전 Play 스토어 버전에만 사용됩니다. 사용자에게 Google Play 스토어에 로그인해 달라고 요청합니다.
CANNOT_BIND_TO_SERVICE Play 스토어의 서비스에 바인딩할 수 없습니다. 기기에 이전 Play 스토어 버전이 설치되어 있기 때문일 수 있습니다. 사용자에게 Google Play 스토어를 업데이트하라고 요청합니다.
APP_NOT_INSTALLED 호출 앱이 설치되어 있지 않습니다. 문제가 발생했습니다. 공격일 수 있습니다. 작업이 불가능합니다.
PLAY_SERVICES_NOT_FOUND Play 서비스를 사용할 수 없거나 업데이트해야 합니다. 사용자에게 Play 서비스를 설치하거나 사용 설정하라고 요청합니다.
PLAY_SERVICES_VERSION_OUTDATED Play 서비스를 업데이트해야 합니다. 사용자에게 Google Play 서비스를 업데이트하라고 요청합니다.
TOO_MANY_REQUESTS 호출 앱이 API에 너무 많은 요청을 해 제한되었습니다. 지수 백오프로 다시 시도합니다.
GOOGLE_SERVER_UNAVAILABLE 알 수 없는 내부 Google 서버 오류입니다. 지수 백오프로 다시 시도합니다.
INTERNAL_ERROR 알 수 없는 내부 오류입니다. 지수 백오프로 다시 시도합니다.
NONCE_TOO_SHORT nonce 길이가 너무 짧습니다. nonce는 최소 16바이트(base64 인코딩 전)여야 합니다. 더 긴 nonce로 다시 시도합니다.
NONCE_TOO_LONG nonce 길이가 너무 깁니다. nonce는 base64 인코딩 전에 500바이트 미만이어야 합니다. 더 짧은 nonce로 다시 시도합니다.
NONCE_IS_NOT_BASE64 nonce 형식이 base64, 웹 안전, 줄바꿈 없음이 아닙니다. 정확한 nonce 형식으로 다시 시도합니다.
CLOUD_PROJECT_NUMBER_IS_INVALID 입력한 클라우드 프로젝트 번호가 잘못되었습니다. Play Integrity API가 사용 설정된 클라우드 프로젝트의 클라우드 프로젝트 번호를 사용합니다.
APP_UID_MISMATCH 호출 앱 UID(사용자 ID)가 패키지 관리자의 UID와 일치하지 않습니다. 문제가 발생했습니다. 공격일 수 있습니다. 작업이 불가능합니다.

네이티브 관련 오류 코드

INTEGRITY_ 접두사는 네이티브 오류 코드 앞에 추가되어 잠재적인 이름 지정 충돌을 방지합니다. 위에 나열된 오류 코드 외에 네이티브 API에는 다음 오류 코드도 포함됩니다.

오류 코드 설명 조치
INTEGRITY_INITIALIZATION_NEEDED IntegrityManager가 초기화되지 않았습니다. 먼저 IntegrityManager_init()를 호출합니다.
INTEGRITY_INITIALIZATION_FAILED Integrity API를 초기화하는 중에 오류가 발생했습니다. 지수 백오프로 다시 시도합니다. 버그 신고를 고려해보세요.
INTEGRITY_INVALID_ARGUMENT 잘못된 인수가 Integrity API에 전달되었습니다. 정확한 인수로 다시 시도합니다.