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 wartości 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 wartości wieku dla swojej aplikacji. Minimalne wartości wieku 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 minimalną wartość wieku (15):

  • W przypadku użytkownika w wieku od 0 do 14 lat zwracane będą wartości ageLower = 0 i ageUpper = 14.
  • W przypadku użytkownika w wieku 15 lat lub starszego zwracana będzie wartość ageLower = 15.

• Jeśli ustawisz 2 minimalne wartości wieku (13 i 17):

  • W przypadku użytkownika w wieku od 0 do 12 lat zwracane będą wartości ageLower = 0 i ageUpper = 12.
  • W przypadku użytkownika w wieku od 13 do 16 lat zwracane będą wartości ageLower = 13 i ageUpper = 16.
  • W przypadku użytkownika w wieku 17 lat lub starszego zwracana będzie wartość ageLower = 17.

• Jeśli ustawisz 3 minimalne wartości wieku (11, 13 i 15):

  • W przypadku użytkownika w wieku od 0 do 10 lat zwracane będą wartości ageLower = 0 i ageUpper = 10.
  • W przypadku użytkownika w wieku 11 lub 12 lat zwracane będą wartości ageLower = 11 i ageUpper = 12.
  • W przypadku użytkownika w wieku 13 lub 14 lat zwracane będą wartości ageLower = 13 i ageUpper = 14.
  • W przypadku użytkownika w wieku 15 lat lub starszego zwracana będzie wartość 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 po otwarciu aplikacji. Twoim obowiązkiem jest zapewnianie treści dostosowanych do wieku odbiorcy za pomocą tych sygnałów.

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

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

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

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

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

• Wartość userStatus będzie równa AgeSignalsVerificationStatus.UNKNOWN.
• Pozostałe pola odpowiedzi będą miały wartość null.

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

• Wartość userStatus będzie równa null.
• Pozostałe pola odpowiedzi będą miały wartość null.

Stan użytkownika może zmienić się na DECLARED, gdy jego wiek będzie można udostępnić.

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

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

W przypadku zweryfikowanego użytkownika otrzymasz te informacje:

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

W przypadku nadzorowanego użytkownika otrzymasz te informacje:

• Wartość userStatus będzie równa AgeSignalsVerificationStatus.SUPERVISED.
• Wartość ageLower będzie liczbą (np. 13).
• Wartość 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).
• Wartość 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:

• Wartość userStatus będzie równa AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING.
• Wartość ageLower będzie liczbą (np. 13).
• Wartość 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).
• Wartość 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 prośbę 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.