Korzystanie z interfejsu Play Age Signals API (beta)

Korzystając z interfejsu Play Age Signals API (beta), akceptujesz warunki korzystania z usługi i zgadzasz się przestrzegać wszystkich zasad Google Play dla deweloperów. Aby poprosić o stan i przedział wiekowy użytkownika, wywołaj interfejs API z poziomu aplikacji w czasie działania. Interfejs Play Age Signals API zwraca dane tylko o użytkownikach z regionów, w których zgodnie z prawem musimy udostępniać dane o kategoriach wiekowych.

Play zwraca przedział wiekowy na podstawie grup wiekowych zdefiniowanych w odpowiednich jurysdykcjach i regionach. Domyślne przedziały wiekowe zwracane przez interfejs API w odpowiednich jurysdykcjach i regionach to 0–12, 13–15, 16–17 i 18+, ale mogą się one zmieniać w zależności od wymagań regionalnych.

Integrowanie interfejsu Play Age Signals API z aplikacją

Aby zintegrować interfejs Play Age Signals API z aplikacją, dodaj ten ciąg do pliku build.gradle aplikacji:

implementation 'com.google.android.play:age-signals:0.0.1-beta01'

Żądanie sygnałów dotyczących wieku

Oto przykład wysyłania żądania sygnałów dotyczących wieku:

// 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 (w wersji beta) zawiera te pola i wartości: Wartości mogą ulec zmianie. Jeśli chcesz uzyskać najnowsze wartości, poproś o odpowiedź z API po otwarciu aplikacji. Odpowiadasz za dostarczanie treści dostosowanych do wieku użytkowników na podstawie tych sygnałów.

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

Jeśli Twoja aplikacja wyśle żądanie do interfejsu Play Age Signals API (w wersji beta) 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.