Play Age Signals API (베타) 사용

Play Age Signals API (베타)를 사용하면 서비스 약관에 동의하고 모든 Google Play 개발자 정책을 준수하는 데 동의하는 것으로 간주됩니다. 사용자의 상태와 연령대를 요청하려면 런타임에 앱에서 API를 호출합니다. Play 연령 신호 API는 법에 따라 Play에서 연령 카테고리 데이터를 제공해야 하는 지역에 거주하는 사용자의 데이터만 반환합니다.

Play는 관련 관할권 및 지역에서 정의한 연령대를 기반으로 연령대를 반환합니다. API가 관련 관할권 및 지역에서 반환하는 기본 연령은 0~12세, 13~15세, 16~17세, 18세 이상이지만 지역 요구사항에 따라 변경될 수 있습니다.

앱에 Play Age Signals API 통합

Play Age Signals API를 앱에 통합하려면 앱의 build.gradle 파일에 다음 종속 항목을 추가하세요.

implementation 'com.google.android.play:age-signals:0.0.1-beta01'

연령 신호 요청

다음은 연령 신호 요청을 만드는 예입니다.

// Create an instance of a manager
AgeSignalsManager ageSignalsManager =
    AgeSignalsManagerFactory.create(ApplicationProvider.getApplicationContext());

// Request an age signals check
ageSignalsManager
    .checkAgeSignals(AgeSignalsRequest.builder().build())
    .addOnSuccessListener(
        ageSignalsResult -> {
          // Store the install ID for later...
          String installId = ageSignalsResult.installId();

          if (ageSignalsResult
              .userStatus()
              .equals(AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED)) {
            // Disallow access ...
          } else {
            // Do something else if the user is SUPERVISED, VERIFIED, etc.
          }
        });

연령 신호는 Google Play에서 각 사용자의 기기에 저장됩니다. 감독 대상 Google 계정을 사용하는 사용자가 새로운 연령대로 바뀌면 Google Play에서는 사용자의 생일 후 2~8주 이내에 해당 사용자의 캐시된 연령 신호를 자동으로 업데이트합니다.

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

API가 관련 관할권 및 지역에서 반환하는 기본 연령대는 0~12세, 13~15세, 16~17세, 18세 이상입니다. 이는 향후 현지 요구사항에 따라 변경될 수 있습니다.

또는 앱의 최소 연령에 따라 연령대를 맞춤설정하려면 Google Play Console의 연령 신호 페이지에서 앱의 최소 연령을 제공하면 됩니다. Age Signals API는 맞춤설정된 연령대를 반환합니다. 예를 들어 최소 연령을 9, 15, 17세로 제공하는 경우 14세 사용자는 10~15세 연령대에 속합니다. 최소 연령은 2세 이상 차이가 나야 하며 연 1회 변경할 수 있습니다.

Age Signals API가 반환하는 연령대를 맞춤설정하려면 앱의 최소 연령을 제공하세요.

1. Play Console에서 연령 신호 페이지로 이동합니다.
2. 앱 사용 가능 최소 연령 탭에 앱의 최소 연령을 최대 3개까지 입력합니다.
3. 저장을 클릭합니다.

연령 신호 응답

Play Age Signals API (베타) 응답에는 다음 필드와 값이 포함됩니다. 값은 변경될 수 있습니다. 최신 값을 원한다면 앱이 열릴 때 API 응답을 요청하세요. 이러한 신호를 사용하여 연령에 적합한 환경을 제공할 책임은 사용자에게 있습니다.

API 오류 코드 처리

앱이 Play Age Signals API (베타) 요청을 하고 호출이 실패하면 앱에 오류 코드가 수신됩니다. 이러한 오류는 Play 스토어 앱이 최신 버전이 아닌 등 다양한 이유로 발생할 수 있습니다.

재시도 전략

사용자가 세션을 진행 중인 상황에서는 오류가 사용자 경험을 최대한 방해하지 않도록 최대 재시도 횟수를 종료 조건으로 사용하는 재시도 전략을 구현하는 것이 좋습니다.