Utiliser l'API Play Age Signals (bêta)

// 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.
          }
        });

(Facultatif) Recevoir des tranches d'âge personnalisées

Les tranches d'âge par défaut renvoyées par l'API dans les juridictions et régions concernées sont 0-12, 13-15, 16-17 et 18 ans et plus.

Vous pouvez également personnaliser les tranches d'âge par défaut en fonction des âges minimaux pour votre application. Pour ce faire, indiquez ces âges minimaux pour votre application sur la page "Signaux d'âge" de la Google Play Console.

1. Accédez à la page Signaux d'âge de la Play Console.
2. Dans l'onglet Tranches d'âge personnalisées, saisissez jusqu'à trois âges minimaux pour votre application. Les âges minimaux ne peuvent être modifiés qu'une fois par an et l'écart entre les valeurs doit être d'au moins deux ans.
3. Cliquez sur Enregistrer.

Les tranches d'âge renvoyées remplaceront la réponse par défaut de l'API. Exemple :

• Si vous définissez un âge minimal (15 ans) dans la Google Play Console :

  • Pour un utilisateur de 0 à 14 ans, ageLower = 0 et ageUpper = 14 seront renvoyés.
  • Pour un utilisateur de 15 ans et plus, ageLower = 15 sera renvoyé.

• Si vous définissez deux âges minimaux (13 et 17 ans) :

  • Pour un utilisateur de 0 à 12 ans, ageLower = 0 et ageUpper = 12 seront renvoyés.
  • Pour un utilisateur de 13 à 16 ans, ageLower = 13 et ageUpper = 16 seront renvoyés.
  • Pour un utilisateur de 17 ans et plus, ageLower = 17 sera renvoyé.

• Si vous définissez trois âges minimaux (11, 13 et 15 ans) :

  • Pour un utilisateur de 0 à 10 ans, ageLower = 0 et ageUpper = 10 seront renvoyés.
  • Pour un utilisateur de 11 ou 12 ans, ageLower = 11 et ageUpper = 12 seront renvoyés.
  • Pour un utilisateur de 13 ou 14 ans, ageLower = 13 et ageUpper = 14 seront renvoyés.
  • Pour un utilisateur de 15 ans et plus, ageLower = 15 sera renvoyé.

Réponses des signaux d'âge

La réponse de l'API Play Age Signals (bêta) inclut les champs et valeurs suivants. Les valeurs sont susceptibles de changer. Si vous souhaitez obtenir les valeurs les plus récentes, demandez une réponse de l'API lorsque votre application s'ouvre. Vous êtes responsable de la fourniture d'expériences adaptées à l'âge à l'aide de ces signaux.

Exemples de réponses pour les utilisateurs au Brésil

Au Brésil, userStatus ne peut être que DECLARED, UNKNOWN, ou null.

Pour un utilisateur qui a déclaré son âge et le partage avec les applications, vous recevrez les informations suivantes :

• userStatus sera AgeSignalsVerificationStatus.DECLARED.
• ageLower sera un nombre (par exemple, 13).
• ageUpper sera un nombre ou null (par exemple, 15).
• Les autres champs de réponse seront null.

Pour un utilisateur dont l'âge est inconnu, vous recevrez les informations suivantes :

• userStatus sera AgeSignalsVerificationStatus.UNKNOWN.
• Les autres champs de réponse seront null.

Pour un utilisateur dont l'âge n'est pas partagé avec les applications, vous recevrez les informations suivantes :

• userStatus sera null.
• Les autres champs de réponse seront null.

L'état de l'utilisateur peut passer à DECLARED une fois que son âge est disponible pour être partagé.

Exemples de réponses pour les utilisateurs dans les États américains

Dans les États américains concernés, userStatus peut être VERIFIED, SUPERVISED, SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED, UNKNOWN, ou null.

Pour un utilisateur validé, vous recevrez les informations suivantes :

• userStatus sera AgeSignalsVerificationStatus.VERIFIED.
• ageLower sera un nombre (par exemple, 18).
• ageUpper sera un nombre ou null (par exemple, null).
• Les autres champs de réponse seront null.

Pour un utilisateur supervisé, vous recevrez les informations suivantes :

• userStatus sera AgeSignalsVerificationStatus.SUPERVISED.
• ageLower sera un nombre (par exemple, 13).
• ageUpper sera un nombre ou null (par exemple, 15).
• mostRecentApprovalDate sera un objet de date Java (par exemple, 2026-01-01) ou null (si aucune modification importante n'a été approuvée).
• installID sera un ID alphanumérique généré par Play (par exemple, 550e8400-e29b-41d4-a716-446655441111).

Pour un utilisateur supervisé dont l'approbation d'une modification importante est en attente, vous recevrez les informations suivantes :

• userStatus sera AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING.
• ageLower sera un nombre (par exemple, 13).
• ageUpper sera un nombre ou null (par exemple, 15).
• mostRecentApprovalDate sera un objet de date Java (par exemple, 2026-01-01) ou null (si aucune modification importante n'a été approuvée).
• installID sera un ID alphanumérique généré par Play (par exemple, 550e8400-e29b-41d4-a716-446655441111).

Gérer les codes d'erreur de l'API

Si votre application envoie une requête à l'API Play Age Signals et que l'appel échoue, elle reçoit un code d'erreur. Ces erreurs peuvent se produire pour diverses raisons, par exemple si l'application Play Store n'est pas à jour.

Stratégie de nouvelle tentative

Lorsqu'une session utilisateur est en cours, nous vous recommandons d'implémenter une stratégie de nouvelle tentative avec un nombre maximal de tentatives comme condition de sortie afin que l'erreur perturbe le moins possible l'expérience utilisateur.