Google Play Integrity API는 Google Play Console의 앱 또는 Play SDK Console의 SDK에 연결되지 않은 Google Cloud 프로젝트의 트래픽에 일일 요청 10,000개 한도를 적용합니다. 이 한도는 대부분의 Google Cloud 프로젝트에 이미 적용되어 있습니다. 기존에 할당량이 상향된 소수의 프로젝트에는 한도가 적용되기 전에 연결을 완료할 수 있도록 2027년 2월 16일까지 연장된 기한이 부여되었습니다.
이 가이드에서는 프로젝트 연결이 할당량에 미치는 영향, Google Cloud 프로젝트를 앱 또는 SDK에 연결하는 방법을 설명하고 자주 묻는 질문(FAQ)에 답변합니다.
간단한 요약
| 주요 세부정보 | 설명 |
|---|---|
| 시행일 | 대부분의 프로젝트에서 이미 활성 상태입니다. 기한 알림을 받은 프로젝트의 경우 2027년 2월 16일 |
| 정책 | 앱 또는 SDK에 연결되지 않은 Cloud 프로젝트에서 발생하는 Play Integrity API 요청은 프로젝트에 구성된 더 높은 맞춤 할당량과 관계없이 하루 10,000개 요청으로 제한됩니다. |
| 영향을 받는 대상 | 앱 (Play Console) 또는 SDK (Play SDK Console)에 연결되지 않은 Google Cloud 프로젝트를 사용하여 하루에 10,000회 이상의 요청을 하는 앱 및 SDK |
| 조치 필요 | Google Play Console에서 Google Cloud 프로젝트를 앱에 연결하거나 Google Play SDK Console에서 SDK에 연결합니다. |
| 할당량 초과 오류 | 하루에 10,000개를 초과하는 연결되지 않은 요청은 TOO_MANY_REQUESTS 오류 (오류 코드 -8)와 함께 실패합니다. |
자주 묻는 질문(FAQ)
Q1: Google Cloud 프로젝트를 연결해야 하는 이유는 무엇인가요?
Play Integrity API는 모든 Google Cloud 프로젝트에 하루 10,000개의 요청이라는 기본 할당량을 제공합니다. 더 많은 볼륨이 필요한 개발자는 할당량 상향을 요청할 수 있습니다.
앱 또는 SDK를 보호하고 승인되지 않은 서드 파티가 할당량을 소진하지 못하도록 하기 위해, 상향된 일일 할당량은 Google Play Console에서 앱에 연결된 Google Cloud 프로젝트 또는 Google Play SDK Console에서 SDK에 연결된 Google Cloud 프로젝트로만 제한됩니다.
Q2: Play Console 또는 Play SDK Console에서 Google Cloud 프로젝트를 연결하려면 어떻게 해야 하나요?
앱 (Google Play Console):
- Google Play 콘솔에 로그인하고 앱을 선택하세요.
- 왼쪽 탐색 메뉴에서 Google Play로 보호됨으로 이동합니다.
- Play Integrity API 옆에 있는 시작하기 (또는 관리)를 선택합니다.
- Cloud 프로젝트 연결을 클릭합니다 (이미 연결된 프로젝트가 있는 경우 프로젝트 추가).
- 연결할 Google Cloud 프로젝트 번호를 선택하거나 입력하고 확인합니다.
SDK (Google Play SDK Console):
- Google Play SDK Console에 로그인하고 SDK를 선택합니다.
- 왼쪽 탐색 메뉴에서 SDK 무결성으로 이동합니다.
- Play Integrity API 옆에 있는 설정을 클릭합니다.
- Cloud 프로젝트 연결을 클릭합니다. 이미 연결된 프로젝트가 있는 경우 다른 프로젝트 추가를 클릭합니다.
- 연결할 Google Cloud 프로젝트 번호를 선택하거나 입력하고 확인합니다.
필수 권한:
- Play Console (앱): 앱에 대한 '프로덕션으로 출시, 기기 제외, Play 앱 서명 사용' 권한이 있어야 합니다.
- Play SDK Console (SDK용): SDK에 대한 '관리' 권한이 있어야 합니다.
- Google Cloud (둘 다): 대상 Google Cloud 프로젝트에 대한 'serviceusage.services.enable' 및 'resourcemanager.projects.get' 권한이 있어야 합니다.
Q3: Cloud 프로젝트가 올바르게 연결되었는지 어떻게 확인할 수 있나요?
앱 (Google Play Console):
- Google Play Console > Play로 보호 > Play Integrity API > 관리를 엽니다.
- 프로젝트 구성 섹션을 확인합니다.
- 나열된 프로젝트 번호가 Play Integrity API를 호출하는 데 사용된 프로젝트 번호와 일치하는지 확인합니다.
SDK (Google Play SDK Console):
- Google Play SDK Console > SDK 무결성 > 설정을 엽니다.
- 프로젝트 구성 섹션을 확인합니다.
- 나열된 프로젝트 번호가 Play Integrity API를 호출하는 데 사용된 프로젝트 번호와 일치하는지 확인합니다.
Q4: 앱 또는 SDK가 Google Play에 없는 경우 클라우드 프로젝트를 연결하려면 어떻게 해야 하나요?
Google Cloud 프로젝트 연결은 Google Play Console에서 관리되는 앱과 Google Play SDK Console에 등록된 SDK에서만 사용할 수 있습니다.
앱이 Google Play 외부에 독점적으로 배포되거나 SDK가 Play SDK Console에 없는 경우 Google Cloud 프로젝트를 연결할 수 없으며 Play Integrity API 트래픽은 기본적으로 하루 10,000개의 요청으로 제한됩니다. 더 높은 할당량을 받으려면 Google Play에 앱을 게시하거나 Play SDK Console에 적격 SDK를 등록하고 Cloud 프로젝트를 연결하세요.
Q5: 여러 Google Cloud 프로젝트를 연결하거나 앱 또는 SDK 간에 하나의 프로젝트를 공유할 수 있나요?
- 앱 또는 SDK당 여러 프로젝트: 단일 앱 또는 SDK에 최대 5개의 Google Cloud 프로젝트를 연결할 수 있습니다.
- 여러 앱에 걸친 하나의 프로젝트: Google Play Console에서 동일한 Google Cloud 프로젝트를 여러 앱에 연결할 수 있습니다. 동일한 Google Cloud 프로젝트를 여러 SDK에 연결하거나 SDK와 앱에 연결하는 것은 지원되지 않습니다.
Q6: 앱 또는 SDK를 관리하지만 조직의 다른 사용자가 Google Cloud 프로젝트를 소유하고 있는 경우 어떻게 해야 하나요?
연결을 완료하려면 Play Console (또는 Play SDK Console)에서 작업을 수행하는 사용자에게 Google Cloud 프로젝트에 대한 필수 권한도 있어야 합니다. 다음 두 가지 방법 중 하나로 이를 조정할 수 있습니다.
- 옵션 A: Google Cloud 프로젝트에서 IAM 액세스를 관리할 수 있는 사용자에게 Google 계정에 'serviceusage.services.enable' 및 'resourcemanager.projects.get' 권한을 일시적으로 부여해 달라고 요청합니다. 연결되면 일상적인 작업에 이러한 권한이 더 이상 필요하지 않습니다.
- 옵션 B: Google Cloud 프로젝트에 이미 'serviceusage.services.enable' 및 'resourcemanager.projects.get'이 있는 팀 구성원에게 필요한 Console 권한을 부여하여 연결 단계를 수행할 수 있도록 합니다.
- 앱 (Play Console): 앱에 '프로덕션으로 출시, 기기 제외, Play 앱 서명 사용' 권한을 부여합니다.
- SDK (Play SDK Console): SDK에 '관리' 권한을 부여합니다.
Q7: 2027년 2월 16일 전에 Cloud 프로젝트를 연결하지 않으면 어떻게 되나요?
2027년 2월 16일 이후에 앱 또는 SDK가 연결되지 않은 Google Cloud 프로젝트를 사용하여 Play Integrity API 요청을 전송하는 경우:
- 일일 요청 최대 10,000개: 요청은 기본 기준 할당량에 따라 정상적으로 계속 성공합니다.
- 일일 요청 10,000개 초과: 연결되지 않은 프로젝트가 일일 요청 10,000개에 도달하면 요청이
TOO_MANY_REQUESTS오류(오류 코드-8)와 함께 거부됩니다.
즉각적인 셀프 서비스 해결:
Cloud 프로젝트가 연결되지 않아 기한이 지난 후 앱 또는 SDK에 TOO_MANY_REQUESTS 오류가 발생하는 경우 Play Console 또는 Play SDK Console에서 누락된 Google Cloud 프로젝트를 연결하면 문제가 해결됩니다.
Q8: Play Integrity API를 사용하고 있지 않습니다. Cloud 프로젝트를 연결하라는 메시지를 받은 이유는 무엇인가요?
Google Cloud 프로젝트에서 연결되지 않은 Play Integrity API 요청이 하루에 10,000개 넘게 생성되고 있어 이 알림을 보내드립니다. 일반적인 이유는 다음과 같습니다.
- Cloud 프로젝트 번호로 구성된 라이브러리 또는 SDK: 일부 라이브러리는 Google Cloud 프로젝트를 사용하여 Play Integrity API를 호출합니다. 앱 또는 SDK에서 이러한 라이브러리를 사용하는 경우 Play Console에서 해당 프로젝트를 앱에 연결하거나 Play SDK Console에서 SDK에 연결하세요.
- 조직의 다른 앱 또는 팀: 다른 팀이 앱 또는 SDK에서 이 Google Cloud 프로젝트를 사용하고 있을 수 있습니다. 엔지니어링팀에 문의하여 앱 또는 SDK를 확인한 다음 Play Console 또는 Play SDK Console에서 프로젝트를 연결하세요.
- 승인되지 않은 트래픽 또는 사용 중지된 통합: 승인되지 않거나 클론된 앱이 프로젝트 번호로 요청을 전송하거나 더 이상 API를 사용하지 않는 경우 별도의 조치가 필요하지 않습니다. 연결되지 않은 요청에 대해 일일 10,000개 요청 한도를 적용하면 원치 않는 트래픽이 제한됩니다.
문의 및 지원
Cloud 프로젝트 연결 또는 Play Integrity API 할당량 관리에 관해 궁금한 점이 있는 경우 다음을 참고하세요.
- Play Integrity 지원 양식: 개발자 지원팀에 문의
- 일반 Play Console 도움말: Play Console 고객센터