Utilizzare l'API Play Age Signals (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.
          }
        });

(Facoltativo) Ricevi fasce d'età personalizzate

Le fasce d'età predefinite che l'API restituisce nelle giurisdizioni e nelle regioni applicabili sono 0-12, 13-15, 16-17 e 18+.

In alternativa, per personalizzare le fasce d'età predefinite in base alle età minime della tua app, puoi indicarle nella pagina Indicatori dell'età di Google Play Console. Le fasce d'età restituite ignorano la risposta API predefinita. Ad esempio, se indichi età minime di 9, 15 e 17 anni, un utente di 14 anni rientrerà nella fascia di età 10-15 anni.

Per personalizzare le fasce d'età predefinite restituite dall'API Age Signals, puoi fornire le età minime per la tua app:

1. Vai alla pagina Indicatori dell'età in Play Console.
2. Nella scheda Fasce d'età personalizzate, inserisci fino a tre età minime per la tua app. Le età minime devono essere separate da almeno 2 anni e possono essere modificate una volta all'anno.
3. Fai clic su Salva.

Risposte dell'API Age Signals

La risposta dell'API Play Age Signals (beta) include i seguenti campi e valori. I valori sono soggetti a modifica. Se vuoi i valori più recenti, richiedi una risposta dell'API all'apertura dell'app. È tua responsabilità fornire esperienze adatte all'età utilizzando questi indicatori.

Risposte di esempio per gli utenti in Brasile

In Brasile, userStatus può essere solo DECLARED e UNKNOWN.

Per un utente che ha dichiarato la propria età, riceverai quanto segue:

• userStatus sarebbe AgeSignalsVerificationStatus.DECLARED.
• ageLower sarebbe un numero (ad esempio 13).
• ageUpper sarebbe un numero o null (ad esempio, 15).
• Gli altri campi di risposta sarebbero null.

Per un utente di cui non è nota l'età, riceverai quanto segue:

• userStatus sarebbe AgeSignalsVerificationStatus.UNKNOWN.
• Gli altri campi di risposta sarebbero null.

Lo stato dell'utente potrebbe cambiare da UNKNOWN a DECLARED una volta che l'età dell'utente è disponibile per la condivisione.

Esempi di risposte per gli utenti negli stati degli Stati Uniti

Negli stati degli Stati Uniti applicabili, userStatus può essere VERIFIED, SUPERVISED, SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED, UNKNOWN o null.

Per un utente verificato, riceverai quanto segue:

• userStatus sarebbe AgeSignalsVerificationStatus.VERIFIED.
• ageLower sarebbe un numero (ad esempio, 18).
• ageUpper sarebbe un numero o null (ad esempio, null).
• Gli altri campi di risposta sarebbero null.

Per un utente supervisionato, riceverai quanto segue:

• userStatus sarebbe AgeSignalsVerificationStatus.SUPERVISED.
• ageLower sarebbe un numero (ad esempio 13).
• ageUpper sarebbe un numero o null (ad esempio, 15).
• mostRecentApprovalDate sarebbe un oggetto data Java (ad esempio, 2026-01-01) o null (se non è stata approvata alcuna modifica significativa).
• installID sarebbe un ID alfanumerico generato da Google Play (ad esempio, 550e8400-e29b-41d4-a716-446655441111).

Per un utente supervisionato con un'approvazione di modifica significativa in attesa, riceverai quanto segue:

• userStatus sarebbe AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING.
• ageLower sarebbe un numero (ad esempio 13).
• ageUpper sarebbe un numero o null (ad esempio, 15).
• mostRecentApprovalDate sarebbe un oggetto data Java (ad esempio, 2026-01-01) o null (se non è stata approvata alcuna modifica significativa).
• installID sarebbe un ID alfanumerico generato da Google Play (ad esempio, 550e8400-e29b-41d4-a716-446655441111).

Gestisci i codici di errore dell'API

Se la tua app effettua una richiesta API Play Age Signals e la chiamata non va a buon fine, l'app riceve un codice di errore. Questi errori possono verificarsi per vari motivi, ad esempio perché l'app Play Store è obsoleta.

Strategia di ripetizione dei tentativi

Nelle situazioni in cui l'utente è in sessione, ti consigliamo di implementare una strategia di ripetizione dei tentativi con un numero massimo di tentativi come condizione di uscita, in modo che l'errore interrompa l'esperienza utente il meno possibile.