Android Developer ID Status API 사용 안내

가이드 요약

Android Developer ID Status API로 패키지 이름과 SHA-256 인증서를 확인하고 모든 등록 상태를 안전하게 처리합니다.

대상: 공식 상태 서비스를 통합하는 개발 도구 제작자, 출시 플랫폼 팀, Android 엔지니어.

출시 점검 순서

전용 Google Cloud 프로젝트에서 Android Developer ID Status API를 사용 설정합니다.
API 키를 제한하고 서버 또는 CI 시크릿 저장소에 보관합니다.
패키지 이름과 선택 입력인 정규화 SHA-256 지문을 보냅니다.
state로 분기하고 HTTP 및 할당량 오류는 따로 처리합니다.

핵심 정보

메서드GET packageRegistrationStatus:check

인증X-Goog-Api-Key header

안정된 결과state field

주의 사항

Google의 사람이 읽는 오류 문구를 안정된 기계 계약으로 파싱하지 마세요. HTTP status와 canonical error status를 사용하고 브라우저 JavaScript에 API 키를 노출하지 않습니다.

상세 안내

요청과 응답 계약

엔드포인트는 경로에 패키지 이름을, 선택 사항인 certificateFingerprint를 쿼리 매개변수로 받습니다. 신뢰할 수 있는 서버 또는 CI에서 X-Goog-Api-Key 헤더로 API 키를 보냅니다.

HTTP 200 응답에는 state가 있습니다. INVALID_ARGUMENT과 PERMISSION_DENIED는 설정 실패로 처리하고 RESOURCE_EXHAUSTED, INTERNAL, UNAVAILABLE만 제한된 지수 백오프로 재시도합니다.

API 키를 쿼리 문자열로 보내지 않습니다.
사람이 읽는 오류 문구로 분기하지 않습니다.
최근 결과를 캐시하고 확인 시각을 붙입니다.

패키지와 인증서 요청

curl --fail --silent \
  -H "X-Goog-Api-Key: $ANDROID_DEVELOPER_ID_API_KEY" \
  "https://androiddeveloperidstatus.googleapis.com/v1/packages/com.example.app/packageRegistrationStatus:check?certificateFingerprint=64_HEX_CHARACTERS"

운영 패키지 이름을 입력하고, 서명까지 확인하려면 실제 배포 APK의 인증서 SHA-256을 추가하세요. 이 조회는 스토어 심사와 별개입니다.

상태 확인 →

자주 묻는 질문

Status API에 OAuth가 필요한가요?

현재 공식 가이드는 이 상태 확인 엔드포인트에 API 키 인증을 안내합니다.

브라우저 JavaScript에서 직접 호출해도 되나요?

재사용 가능한 Google API 키를 노출하면 안 됩니다. 보호된 서버 또는 CI에서 호출하세요.

출처 및 검토

최종 검토일: 2026-09-08

Android Developer ID Status API