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 SUPERVISED, VERIFIED, 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.
          }
        });

Sygnały dotyczące wieku są przechowywane przez Google Play na urządzeniu dla każdego użytkownika. Gdy użytkownik z nadzorowanym kontem Google osiągnie wiek, który kwalifikuje go do nowej kategorii wiekowej, Google Play automatycznie zaktualizuje zapisane sygnały wieku tego użytkownika w ciągu 2–8 tygodni od jego urodzin.

(Opcjonalnie) Otrzymywanie niestandardowych przedziałów wiekowych

Domyślne zakresy wiekowe zwracane przez interfejs API w odpowiednich jurysdykcjach i regionach to 0–12, 13–15, 16–17 i 18+. W przyszłości mogą one ulec zmianie w zależności od lokalnych wymagań.

Możesz też dostosować zakresy wieku do minimalnych progów wiekowych aplikacji, podając te progi na stronie Sygnały dotyczące wieku w Konsoli Google Play. Interfejs Age Signals API zwraca dostosowane przedziały wiekowe. Jeśli na przykład podasz minimalny wiek 9, 15 i 17 lat, 14-letni użytkownik będzie mieścił się w przedziale wiekowym 10–15 lat. Minimalny wiek musi różnić się o co najmniej 2 lata i można go zmienić raz w roku.

Aby dostosować zakresy wieku zwracane przez interfejs Age Signals API, możesz podać minimalne progi wiekowe dla swojej aplikacji:

1. Otwórz stronę Sygnały dotyczące wieku w Konsoli Play.
2. Na karcie Minimalny wiek użytkownika aplikacji wpisz maksymalnie 3 minimalne progi wiekowe dla swojej aplikacji.
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ź interfejsu API po otwarciu aplikacji. Odpowiadasz za zapewnienie treści odpowiednich dla wieku użytkowników na podstawie tych sygnałów.

Przykładowe odpowiedzi

Zweryfikowany użytkownik otrzyma:

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

W przypadku nadzorowanego użytkownika otrzymasz:

• userStatus będzie mieć wartość AgeSignalsVerificationStatus.SUPERVISED.
• ageLower to liczba (np. 13).
• ageUpper będzie liczbą (np. 15).
• mostRecentApprovalDate będzie obiektem daty w języku Java (np. 2026-01-01) lub pusty (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 te informacje:

• userStatus to:AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING
• ageLower to liczba (np. 13).
• ageUpper będzie liczbą (np. 15).
• mostRecentApprovalDate będzie obiektem daty w języku Java (np. 2026-01-01) lub pusty (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 (beta), a wywołanie się nie powiedzie, otrzyma kod błędu. Błędy te mogą wystąpić 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.