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+.

Aby dostosować domyślne przedziały wiekowe do minimalnego wieku użytkowników Twojej aplikacji, możesz podać te minimalne progi wiekowe na stronie Sygnały dotyczące wieku w Konsoli Google Play. Zwrócone przedziały wiekowe zastąpią domyślną odpowiedź interfejsu API. Na przykład jeśli podasz minimalne progi wiekowe 9, 15 i 17 lat, 14-letni użytkownik będzie mieścił się w przedziale wiekowym 10–15 lat.

Aby dostosować domyślne przedziały wiekowe zwracane przez interfejs Age Signals API, możesz podać minimalny wiek użytkowników Twojej aplikacji:

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

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ź z interfejsu API po otwarciu aplikacji. Odpowiadasz za zapewnienie treści odpowiednich dla wieku użytkowników na podstawie tych sygnałów.

Przykładowe odpowiedzi dla użytkowników w Brazylii

W Brazylii 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 następujące informacje:

• Wartość userStatus to AgeSignalsVerificationStatus.DECLARED.
• ageLower to liczba (np. 13).
• ageUpper to liczba lub 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 to 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 to null.
• Pozostałe pola odpowiedzi będą miały wartość null.

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

Przykładowe odpowiedzi dla użytkowników ze stanów USA

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

Zweryfikowany użytkownik otrzyma:

• Wartość userStatus to AgeSignalsVerificationStatus.VERIFIED.
• ageLower to liczba (np. 18).
• ageUpper to liczba lub null (np. null).
• Pozostałe pola odpowiedzi będą miały wartość null.

W przypadku nadzorowanego użytkownika otrzymasz:

• Wartość userStatus to AgeSignalsVerificationStatus.SUPERVISED.
• ageLower to liczba (np. 13).
• ageUpper to liczba lub null (np. 15).
• mostRecentApprovalDate będzie obiektem daty w języku Java (np. 2026-01-01) lub null (jeśli nie zatwierdzono istotnej zmiany).
• installID to alfanumeryczny identyfikator wygenerowany przez Google Play (np.550e8400-e29b-41d4-a716-446655441111).

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

• userStatus będzie mieć wartość AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING.
• ageLower to liczba (np. 13).
• ageUpper to liczba lub null (np. 15).
• mostRecentApprovalDate będzie obiektem daty w języku Java (np. 2026-01-01) lub null (jeśli nie zatwierdzono istotnej zmiany).
• installID to alfanumeryczny identyfikator wygenerowany 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 i wywołanie się nie powiedzie, otrzyma kod błędu. Błędy te mogą występować z różnych powodów, np. z powodu nieaktualnej aplikacji Sklep Play.

Strategia ponawiania

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