이 문서에서는 Play Age Signals API에서 반환하는 연령 신호 응답을 설명합니다.
(선택사항) 맞춤 연령대 수신
API에서 반환하는 기본 연령대는 0-12, 13-15, 16-17, 18+입니다.
또는 앱의 최소 연령에 따라 기본 연령대를 맞춤설정하려면 Google Play Console의 연령 신호 페이지에서 앱의 최소 연령을 제공하면 됩니다.
- Play Console의 연령 신호 페이지로 이동합니다.
- 맞춤 연령대 탭에서 앱의 최소 연령을 최대 3개까지 입력합니다. 최소 연령 간의 차이는 2세 이상이어야 하며 연 1회 변경할 수 있습니다.
- 저장을 클릭합니다.
반환되는 연령대가 기본 API 응답을 재정의합니다. 예를 들면 다음과 같습니다.
- Google Play Console에서 최소 연령을 15세로 설정하는 경우:
- 0~14세는
ageLower = 0및ageUpper = 14를 반환합니다. - 만 15세 이상은
ageLower = 15를 반환합니다.
- 0~14세는
- 최소 연령을 2개(13세 및 17세) 설정하는 경우:
- 0~12세의 경우
ageLower = 0및ageUpper = 12가 반환됩니다. - 만 13~16세는
ageLower = 13및ageUpper = 16를 반환합니다. - 만 17세 이상은
ageLower = 17을 반환합니다.
- 0~12세의 경우
- 최소 연령을 3개(11, 13, 15) 설정하는 경우:
- 0~10세는
ageLower = 0및ageUpper = 10를 반환합니다. - 11세 또는 12세는
ageLower = 11및ageUpper = 12를 반환합니다. - 만 13세 또는 14세인 경우
ageLower = 13및ageUpper = 14가 반환됩니다. - 만 15세 이상은
ageLower = 15를 반환합니다.
- 0~10세는
연령 신호 응답 필드
Play Age Signals API(베타) 응답에는 다음 필드와 값이 포함됩니다. 이러한 신호를 사용하여 연령에 적합한 환경을 제공할 책임은 개발자에게 있습니다.
| 응답 필드 | 유형 | 값 | 설명 |
|---|---|---|---|
| ageRangeSource | Enum |
|
|
| ageLower | 정수 |
|
사용자 연령대의 하한값(포함)입니다. ageUpper와 결합하여 범위를 결정합니다.
ageSignalsStatus가 NOT_SHARED 또는 VERIFICATION_REQUIRED인 경우 null을 반환합니다. |
| ageUpper | 정수 |
|
사용자 연령대의 상한값(포함)입니다.
가장 높은 연령대(예: 만 18세 이상) 또는 ageSignalsStatus가 NOT_SHARED 또는 VERIFICATION_REQUIRED인 경우 null을 반환합니다. |
| significantChangeStatus | Enum |
|
이는 중대한 변경사항이 적용되는 관할권에서만 null이 아닌 값을 반환합니다.
|
| significantChangeApprovalDate | 날짜 |
|
가장 최근에 승인된 주요 변경사항의 시행일입니다. 이 날짜 이전의 시행일이 있는 모든 변경사항도 승인됩니다. 변경사항이 없으면 null을 반환합니다.
`significantChangeStatus` 와 결합하여 이 중요한 변경사항의 승인 상태를 가져옵니다. |
| installId | 문자열 |
|
Google Play에서 감독 대상 사용자 설치에 할당한 ID로, 앱 승인 취소를 알리는 데 사용됩니다. 취소된 앱 승인에 관한 문서를 검토합니다. |
예 1
디지털 신분증을 사용하여 연령을 인증한 성인 사용자의 경우 다음을 수신합니다.
연령 인증이 필수인 규제 지역:
ageRangeSource은AgeRangeSource.TIER_D입니다.ageLower은 숫자입니다(예: 18).ageUpper은null입니다.- 다른 응답 필드는
null입니다.
기타 국가:
ageRangeSource은AgeRangeSource.TIER_A입니다.ageLower은 숫자입니다(예: 18).ageUpper은null입니다.- 다른 응답 필드는
null입니다.
예 2
연령 추정 방법(예: 셀피 평가, 신용카드, 세금 ID)을 사용하여 연령을 인증한 성인 사용자의 경우 다음을 받게 됩니다.
연령 인증이 필수인 규제 지역:
ageRangeSource은AgeRangeSource.TIER_C입니다.ageLower은 숫자입니다(예: 18).ageUpper은null입니다.- 다른 응답 필드는
null입니다.
기타 국가:
ageRangeSource은AgeRangeSource.TIER_A입니다.ageLower은 숫자입니다(예: 18).ageUpper은null입니다.- 다른 응답 필드는
null입니다.
예시 3
연령 인증이 필수가 아니며 앱과 공유하는 지역에 있는 사용자의 경우 다음을 수신합니다.
ageRangeSource은AgeRangeSource.TIER_A입니다.ageLower은 숫자입니다(예: 18).ageUpper은null입니다.- 다른 응답 필드는
null입니다.
예 4
보호자가 연령을 관리하고 앱과 공유한 감독 대상 미성년자 사용자의 경우 다음을 수신합니다.
ageRangeSource은AgeRangeSource.TIER_B입니다.ageLower은 숫자입니다(예: 13).ageUpper은 숫자입니다(예: 15).- 다른 응답 필드는
null입니다.
예 5
연령 인증이 필수가 아닌 지역에서 연령 공유에 동의하지 않은 사용자(또는 부모가 동의하지 않은 사용자)의 경우 다음이 수신됩니다.
ageRangeSource은null입니다.ageLower은null입니다.ageUpper은null입니다.- 다른 응답 필드는
null입니다.
예시 6
보호자가 연령을 관리하고, 중요한 변경사항이 승인되었으며, 활성 설치 추적이 사용 설정된 감독 대상 미성년자 사용자의 경우 다음을 수신합니다.
ageRangeSource은AgeRangeSource.TIER_B입니다.ageLower은 숫자입니다(예: 13).ageUpper은 숫자입니다(예: 15).significantChangeStatus은SignificantChangeStatus.APPROVED입니다.significantChangeApprovalDate는 날짜입니다(예: '2026-01-15').installId는 문자열 식별자입니다(예: 'abc123xyz789').