연령 신호 응답 이해하기

이 문서에서는 Play Age Signals API에서 반환하는 연령 신호 응답을 설명합니다.

(선택사항) 맞춤 연령대 수신

API에서 반환하는 기본 연령대는 0-12, 13-15, 16-17, 18+입니다.

또는 앱의 최소 연령에 따라 기본 연령대를 맞춤설정하려면 Google Play Console의 연령 신호 페이지 에서 앱의 최소 연령을 제공하면 됩니다.

  1. Play Console의 연령 신호 페이지로 이동합니다.
  2. 맞춤 연령대 탭에서 앱의 최소 연령을 최대 3개까지 입력합니다. 최소 연령 간의 차이는 2세 이상이어야 하며 연 1회 변경할 수 있습니다.
  3. 저장 을 클릭합니다.

반환된 연령대는 기본 API 응답을 재정의합니다. 예를 들면 다음과 같습니다.

  • Google Play Console에서 최소 연령을 1개 (15)로 설정한 경우:
    • 만 0~14세는 ageLower = 0 및 ageUpper = 14를 반환합니다.
    • 만 15세 이상은 ageLower = 15를 반환합니다.
  • 최소 연령을 2개 (13 및 17)로 설정한 경우:
    • 만 0~12세는 ageLower = 0 및 ageUpper = 12를 반환합니다.
    • 만 13~16세는 ageLower = 13 및 ageUpper = 16을 반환합니다.
    • 만 17세 이상은 ageLower = 17을 반환합니다.
  • 최소 연령을 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를 반환합니다.

연령 신호 응답 필드

Play Age Signals API (베타) 응답에는 다음 필드와 값이 포함됩니다. 이러한 신호를 사용하여 연령에 적합한 환경을 제공할 책임은 사용자에게 있습니다.

응답 필드 유형 값 설명
ageRangeSource Enum
  • TIER_A
  • TIER_B
  • TIER_C
  • TIER_D
  • null
  • TIER_A: 사용자가 연령을 직접 신고했습니다.
  • TIER_B: 사용자의 연령이 부모 또는 보호자에 의해 관리됩니다.
  • TIER_C: 신용카드, 이메일 주소, 셀피 평가, 정부 발급 신분증 또는 세금 ID를 사용하여 사용자의 연령이 평가됩니다.
  • TIER_D: 정부 발급 신분증과 셀피 평가 또는 디지털 신분증의 조합 을 사용하여 사용자의 연령이 확인됩니다.
  • null: ageSignalsStatus 가 NOT_SHARED 또는 VERIFICATION_REQUIRED 인 경우 반환됩니다.
ageLower 정수
  • 0~18
  • null
 사용자 연령대의 하한값을 포함합니다. ageUpper 와 결합하여 대역을 결정합니다.

ageSignalsStatus 가 NOT_SHARED 또는 VERIFICATION_REQUIRED 인 경우 null 을 반환합니다.
ageUpper 정수
  • 2~18
  • null
 사용자 연령대의 상한값을 포함합니다.

최고 대역 (예: 18세 이상) 또는 ageSignalsStatus 가 NOT_SHARED 또는 VERIFICATION_REQUIRED 인 경우 null 을 반환합니다.
significantChangeStatus Enum
  • 승인됨
  • 대기 중
  • DECLINED
  • null
 중요한 변경사항이 적용되는 관할권에서만 null이 아닌 값을 반환합니다.
  • 승인됨: 가장 최근의 중요한 변경사항 (및 이전의 모든 변경사항)이 승인되었습니다.
  • 대기 중: 부모가 하나 이상의 대기 중인 중요한 변경사항을 아직 승인하지 않았습니다.
  • 거부됨: 부모가 하나 이상의 중요한 변경사항에 대한 승인을 거부했습니다.
  • null: 다음의 경우 반환됩니다:
    • 모든 관리 대상이 아닌 계정
    • 아직 중요한 변경사항이 기록되지 않은 관리 대상 계정
significantChangeApprovalDate 날짜
  • DateStamp
  • null
 가장 최근에 승인된 중요한 변경사항의 시행일입니다. 이 날짜 이전의 시행일이 있는 모든 변경사항도 승인됩니다. 변경사항이 없으면 null 을 반환합니다.

`significantChangeStatus` 와 결합하여 이 중요한 변경사항의 승인 상태를 가져옵니다.
installId 문자열
  • 영숫자
  • null
 Google Play에서 관리 대상 사용자 설치에 할당한 ID로, 앱 승인 취소를 알리는 데 사용됩니다. 앱 승인 취소에 관한 문서를 검토하세요.

예 1

디지털 신분증을 사용하여 연령을 인증하고 앱과 공유하는 사용자의 경우 다음을 받게 됩니다.

  • ageRangeSource는 AgeRangeSource.TIER_D입니다.
  • ageLower는 숫자 (예: 18)입니다.
  • ageUpper는 null입니다.
  • 다른 응답 필드는 null입니다.

예 2

연령을 신고 (직접 신고)하고 앱과 공유하는 성인 사용자의 경우 다음을 받게 됩니다.

  • ageRangeSource는 AgeRangeSource.TIER_A입니다.
  • ageLower는 숫자 (예: 18)입니다.
  • ageUpper는 null입니다.
  • 다른 응답 필드는 null입니다.

예 3

연령이 보호자에 의해 관리되고 앱과 공유된 관리 대상 미성년 사용자의 경우 다음을 받게 됩니다.

  • ageRangeSource는 AgeRangeSource.TIER_B입니다.
  • ageLower는 숫자 (예: 13)입니다.
  • ageUpper는 숫자 (예: 15)입니다.
  • 다른 응답 필드는 null입니다.

예 4

연령 공유에 동의하지 않은 사용자 (또는 부모가 동의하지 않은 사용자)의 경우 다음을 받게 됩니다.

  • ageRangeSource는 null입니다.
  • ageLower은 null입니다.
  • ageUpper는 null입니다.
  • 다른 응답 필드는 null입니다.

예 5

연령 추정 방법(예: 셀피 평가, 신용카드 또는 세금 ID)을 사용하여 확인된 연령이 있고 앱과 공유하는 성인 사용자의 경우 다음을 받게 됩니다.

  • ageRangeSource는 AgeRangeSource.TIER_C입니다.
  • ageLower는 숫자 (예: 18)입니다.
  • ageUpper는 null입니다.
  • 다른 응답 필드는 null입니다.

예 6

중요한 변경사항이 승인되고 설치 추적이 활성화된 보호자가 연령을 관리하는 관리 대상 미성년 사용자의 경우 다음을 받게 됩니다.

  • ageRangeSource는 AgeRangeSource.TIER_B입니다.
  • ageLower는 숫자 (예: 13)입니다.
  • ageUpper는 숫자 (예: 15)입니다.
  • significantChangeStatus는 SignificantChangeStatus.APPROVED입니다.
  • significantChangeApprovalDate 는 날짜 (예: '2026-01-15')입니다.
  • installId는 문자열 식별자 (예: 'abc123xyz789')입니다.
이전
연령 신호 요청
다음
연령 신호 테스트