Korzystanie z interfejsu Play Age Signals API (beta)

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

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

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

// 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.
          }
        });

(Opcjonalnie) Otrzymywanie niestandardowych przedziałów wiekowych

Domyślne przedziały wiekowe zwracane przez interfejs API w odpowiednich jurysdykcjach i regionach to 0–12, 13–15, 16–17 oraz 18+.

Możesz też dostosować domyślne przedziały wiekowe do minimalnego wieku użytkowników Twojej aplikacji , podając te minimalne progi wiekowe na stronie Sygnały dotyczące wieku w Konsoli Google Play.

1. Otwórz stronę Sygnały dotyczące wieku w Konsoli Play.
2. Na karcie Niestandardowe przedziały wiekowe wpisz maksymalnie 3 minimalne progi wiekowe dla swojej aplikacji. Minimalne progi wiekowe muszą różnić się o co najmniej 2 lata i można je zmienić raz na rok.
3. Kliknij Zapisz.

Zwracane przedziały wiekowe zastąpią domyślną odpowiedź interfejsu API. Przykład:

• Jeśli w Konsoli Google Play ustawisz 1 minimalny próg wiekowy (15 lat):

  • W przypadku użytkownika w wieku od 0 do 14 lat zwrócimy ageLower = 0 i ageUpper = 14.
  • W przypadku użytkownika w wieku 15 lat lub starszego zwrócimy ageLower = 15.

• Jeśli ustawisz 2 minimalne progi wiekowe (13 i 17 lat):

  • W przypadku użytkownika w wieku od 0 do 12 lat zwrócimy ageLower = 0 i ageUpper = 12.
  • W przypadku użytkownika w wieku od 13 do 16 lat zwrócimy ageLower = 13 i ageUpper = 16.
  • W przypadku użytkownika w wieku 17 lat lub starszego zwrócimy ageLower = 17.

• Jeśli ustawisz 3 minimalne progi wiekowe (11, 13 i 15 lat):

  • W przypadku użytkownika w wieku od 0 do 10 lat zwrócimy ageLower = 0 i ageUpper = 10.
  • W przypadku użytkownika w wieku 11 lub 12 lat zwrócimy ageLower = 11 i ageUpper = 12.
  • W przypadku użytkownika w wieku 13 lub 14 lat zwrócimy ageLower = 13 i ageUpper = 14.
  • W przypadku użytkownika w wieku 15 lat lub starszego zwrócimy ageLower = 15.

Odpowiedzi na sygnały dotyczące wieku

Odpowiedź interfejsu Play Age Signals API (beta) zawiera te pola i wartości. Wartości mogą ulec zmianie. Jeśli chcesz uzyskać najnowsze wartości, poproś o odpowiedź interfejsu API, gdy aplikacja się otworzy. Ponosisz odpowiedzialność za zapewnianie treści dostosowanych do wieku odbiorcy za pomocą tych sygnałów.

Przykładowe odpowiedzi dotyczące użytkowników w Brazylii

W Brazylii userStatus może mieć tylko wartość DECLARED, UNKNOWN, lub null.

W przypadku użytkownika, który zadeklarował swój wiek i udostępnia go aplikacjom, otrzymasz te informacje:

• userStatus będzie mieć wartość AgeSignalsVerificationStatus.DECLARED.
• ageLower będzie liczbą (np. 13).
• ageUpper będzie liczbą lub wartością null (np. 15).
• Pozostałe pola odpowiedzi będą mieć wartość null.

W przypadku użytkownika, którego wiek jest nieznany, otrzymasz te informacje:

• userStatus będzie mieć wartość AgeSignalsVerificationStatus.UNKNOWN.
• Pozostałe pola odpowiedzi będą mieć wartość null.

W przypadku użytkownika, którego wiek nie jest udostępniany aplikacjom, otrzymasz te informacje:

• userStatus będzie mieć wartość null.
• Pozostałe pola odpowiedzi będą mieć wartość null.

Gdy wiek użytkownika będzie dostępny do udostępnienia, stan użytkownika może zmienić się na DECLARED.

Przykładowe odpowiedzi dotyczące użytkowników w stanach USA

W odpowiednich stanach USA userStatus może mieć wartość VERIFIED, SUPERVISED, SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED, UNKNOWN, lub null.

W przypadku zweryfikowanego użytkownika otrzymasz te informacje:

• userStatus będzie mieć wartość AgeSignalsVerificationStatus.VERIFIED.
• ageLower będzie liczbą (np. 18).
• ageUpper będzie liczbą lub wartością null (np. null).
• Pozostałe pola odpowiedzi będą mieć wartość null.

W przypadku nadzorowanego użytkownika otrzymasz te informacje:

• userStatus będzie mieć wartość AgeSignalsVerificationStatus.SUPERVISED.
• ageLower będzie liczbą (np. 13).
• ageUpper będzie liczbą lub wartością null (np. 15).
• mostRecentApprovalDate będzie obiektem daty Java (np. 2026-01-01) lub null (jeśli nie zatwierdzono żadnej istotnej zmiany).
• installID będzie alfanumerycznym identyfikatorem wygenerowanym przez Google Play (np. 550e8400-e29b-41d4-a716-446655441111).

W przypadku nadzorowanego użytkownika, który oczekuje na zatwierdzenie istotnej zmiany, otrzymasz te informacje:

• userStatus będzie mieć wartość AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING.
• ageLower będzie liczbą (np. 13).
• ageUpper będzie liczbą lub wartością null (np. 15).
• mostRecentApprovalDate będzie obiektem daty Java (np. 2026-01-01) lub null (jeśli nie zatwierdzono żadnej istotnej zmiany).
• installID będzie alfanumerycznym identyfikatorem wygenerowanym przez Google Play (np. 550e8400-e29b-41d4-a716-446655441111).

Obsługa kodów błędów interfejsu API

Jeśli aplikacja wyśle żądanie do interfejsu Play Age Signals API, a wywołanie się nie powiedzie, aplikacja otrzyma kod błędu. Błędy te mogą występować z różnych powodów, np. z powodu nieaktualnej wersji aplikacji Sklep Play.

Strategia ponawiania

W sytuacjach, gdy użytkownik jest zalogowany, zalecamy wdrożenie strategii ponawiania z maksymalną liczbą prób jako warunkiem zakończenia, aby błąd jak najmniej zakłócał korzystanie z aplikacji.