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 przedziały 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ć 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. Interfejs Age Signals API zwraca dostosowane przedziały wiekowe. Na przykład jeśli podasz minimalne progi wiekowe 9, 15 i 17 lat, 14-letni użytkownik będzie mieścił się w zakresie wiekowym 10–15 lat.

Aby dostosować zakresy wieku 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 przedziały 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

Zweryfikowany użytkownik otrzyma:

• Wartość userStatus to AgeSignalsVerificationStatus.VERIFIED.
• Pozostałe pola odpowiedzi będą puste.

W przypadku nadzorowanego użytkownika otrzymasz:

• Wartość userStatus to 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 żadnej 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:

• Wartość 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 żadnej 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ą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.