API Google Play Age Signals en 2026 : un tutoriel pas à pas pour les tranches d’âge, les approbations de changement significatif et
La vérification de l’âge est passée de l’application au store. Le Texas SB 2420 est désormais en vigueur, le Digital ECA brésilien a commencé à renvoyer des signaux d’âge le 17 mars 2026, et Google Play fournit maintenant aux développeurs une réponse qu’ils devaient auparavant deviner : quel âge a cet utilisateur ? L’API Play Age Signals (bêta) est la porte côté client vers cette réponse. Ce tutoriel suit l’ordre d’intégration qui évite une réécriture.
Un point de cadrage à clarifier d’abord : Google Play n’impose pas l’API. Les lois créent des obligations pour les applications distribuées dans ces juridictions ; Google fournit les outils et vous laisse la décision de conformité. Consignez cette décision par écrit — une piste d’audit vaut mieux qu’un souvenir de fil Slack.
Étape 1 — comprendre ce qui a réellement changé en 2026
Trois faits datés, tous issus de la documentation officielle de Google, définissent le périmètre :
- Texas. Le App Store Accountability Act (SB 2420) est en vigueur après que la cour d’appel fédérale a suspendu l’injonction préliminaire rendue en décembre 2025. Pour les utilisateurs éligibles, Google Play renvoie des signaux d’âge pour les comptes créés après le 28 mai 2026, et d’autres mises à jour sont annoncées avant les lois sur la vérification de l’âge dans d’autres États américains (aide Play Console).
- Brésil. Depuis le 17 mars 2026, l’API renvoie des signaux d’âge pour les utilisateurs au Brésil afin de répondre aux exigences du Digital ECA (Vue d’ensemble des signaux d’âge).
- Répartition des obligations. Le store vérifie, les parents approuvent, et le développeur doit intégrer les tranches d’âge ainsi que le statut d’approbation parentale pour les changements significatifs, et notifier le store lorsqu’un changement significatif survient. La FAQ de Play indique clairement qu’elle n’exige pas l’Age Signals API — ce sont les lois qui exigent des expériences adaptées à l’âge.
Concrètement, cela signifie que l’API résout la partie la plus difficile (vous ne pouvez pas vérifier une date de naissance vous-même sans collecter des données d’identité que vous préféreriez ne pas détenir) et vous laisse la partie que vous maîtrisez réellement : ce que l’app fait différemment pour une tranche 13-15 ans par rapport à une tranche 18+.
Étape 2 — Ajoutez la dépendance et respectez les limites de surface
La bibliothèque cliente est com.google.android.play:age-signals, et Google recommande la dernière version, 0.0.4. Les formats pris en charge sont les téléphones, les pliables et les tablettes sous Android 6.0 (niveau d’API 23) et supérieur. Ajoutez-la au module de l’application :
implementation 'com.google.android.play:age-signals:0.0.4'
Deux contraintes sont faciles à manquer. D’abord, il s’agit d’une API côté client, à l’exécution : les signaux d’âge sont récupérés pendant que l’application est ouverte, pas poussés vers un backend, donc tout contrôle côté serveur doit être piloté par ce que l’application a obtenu, puis décider comment le transmettre. Ensuite, en utilisant l’API, vous acceptez ses conditions d’utilisation et vous engagez à respecter les politiques développeur de Google Play.
Étape 3 — Demandez l'accès avant de demander l'âge
Appeler checkAgeSignals() en premier est l’erreur classique. Vous devez d’abord résoudre le statut de partage via requestAgeSignalsAccess(activity), qui renvoie l’un de trois états, chacun exigeant une interface différente :
PARTAGÉ— les signaux d'âge peuvent être lus. Cela couvre un adulte qui a vérifié son âge ou l'a déclaré lui-même dans une région éligible au partage automatique, ainsi qu'un mineur supervisé dont le parent a partagé l'âge.NOT_SHARED— l'utilisateur ou son parent a refusé. Votre expérience de repli s'applique ; ne relancez pas en boucle.VERIFICATION_REQUIRED— dans les États américains concernés, l’utilisateur doit se vérifier dans le Play Store avant qu’un signal n’existe. Redirigez-le vers ce parcours et rendez la requête idempotente au retour.
Le comportement varie selon la région, par conception. Là où un choix est requis (par exemple dans l’UE, au Royaume-Uni et au Brésil), les utilisateurs choisissent Demander avant de partager, Toujours partager ou Ne jamais partager ; avec Demander avant de partager, Play affiche une invite intégrée dans l’application. Dans les États américains concernés, il n’y a aucune invite dans l’application — le Play Store gère la vérification, et les appels renvoient SHARED ou VERIFICATION_REQUIRED. Pour les comptes supervisés, les parents gèrent le partage dans l’application Family Link. Si un utilisateur ferme l’invite, Play la réaffiche quelques fois puis la supprime — c’est pourquoi un blocage strict sur NOT_SHARED relève d’une décision produit, pas d’un comportement technique par défaut.
Étape 4 — Lisez les champs de réponse sans mal interpréter null
checkAgeSignals() renvoie les champs qui déterminent votre logique de branchement (référence de réponse) :
ageLower/ageUpper— bornes incluses de la tranche d’âge de l’utilisateur. Les tranches par défaut sont 0-12, 13-15, 16-17 et 18+.ageUpperest null pour la tranche ouverte la plus élevée.ageRangeSource—TIER_Aauto-déclaré ;TIER_Bgéré par le parent/tuteur ;TIER_Cévalué via carte bancaire, e-mail, évaluation par selfie, pièce d’identité officielle ou identifiant fiscal ;TIER_Dpièce d’identité officielle plus évaluation par selfie, ou identité numérique. Traitez le palier comme un indice de confiance et consignez-le à côté de la branche retenue.significantChangeStatus/significantChangeApprovalDate—APPROVED,PENDING,DECLINED, ou null lorsque la juridiction ne s’applique pas.installId— attribué aux installations supervisées, utilisé pour les notifications de révocation d'approbation d'application.
Le piège : des bornes null ne signifient pas « enfant ». Les deux bornes reviennent à null pour un adulte vérifié, et elles reviennent aussi à null lorsque le statut est NOT_SHARED ou VERIFICATION_REQUIRED. Si votre code associe « null » à « restreint », vous bloquerez des adultes payants. Branchez d’abord sur le statut, puis sur les bornes, et traitez des bornes null comme « inconnu, utilisez le palier par défaut », sauf indication contraire du statut.
Étape 5 — Définir des tranches d’âge personnalisées dans la Play Console si votre produit en a besoin
Les tranches par défaut correspondent rarement à une règle produit réelle. Sur la page Signaux d’âge de la Play Console, l’onglet Tranches d’âge personnalisées accepte jusqu’à trois âges minimum ; ces âges minimum doivent être espacés d’au moins deux ans et ne peuvent être modifiés qu’une fois par an. Définissez un minimum de 15 ans : un utilisateur de 0-14 ans renvoie ageLower=0, ageUpper=14, tandis qu’un utilisateur de 15 ans et plus renvoie uniquement ageLower=15. Définissez 13 et 17 et vous obtenez trois tranches : 0-12, 13-16, 17+.
Comme la modification est annuelle, déterminez les tranches à partir des règles de votre produit et de vos engagements de fiche App Store avant d'enregistrer. Un réajustement ultérieur constitue une demande de modification, pas un simple ajustement de configuration.
Étape 6 — Configurer les changements significatifs et les classifications par âge des achats intégrés
La « modification significative » est définie par vous, pas par Google. Lorsque vous en apportez une — nouvelle fonctionnalité sociale, changement dans le partage de données, nouvelle surface d’achat —, signalez-la à Play sur la page Signaux d’âge dans Play Console ; aucune nouvelle version de l’application n’est requise. Les parents approuvent ou refusent ensuite, et vous lisez le résultat via significantChangeStatus. Play précise qu’elle ne révoquera pas l’accès à l’application et ne la désactivera pas en cas de refus parental : la conséquence vous revient, et le chemin de notification des approbations révoquées passe par installId.
Le Texas ajoute un circuit distinct pour l’argent : les produits intégrés peuvent nécessiter leur propre classification par âge, distincte de la classification du contenu de l’application. Vous pouvez la définir dans Play Console ou via la Publishing API, et Play l’affiche dans le parcours d’approbation d’achat pour les utilisateurs du Texas sur Play Billing. Traitez la classification du SKU comme un élément de la liste de vérification de version, pas comme une réflexion après coup — un parcours d’achat qui l’omet est exactement le type de lacune qui ressort en constat de non-conformité plutôt qu’en plantage.
Étape 7 — Traiter les codes d’erreur en deux groupes, pas en onze cas
Le tableau des erreurs se divise en réalité en deux groupes. Réessayables : -1 API indisponible, -2 Play Store absent, -3 réseau, -4 Play Services absent, -5 impossible de se lier au service, -6 Play Store obsolète, -7 Play Services obsolète, -8 erreur transitoire côté client. Non réessayables : -9 application non installée via Google Play, -10 version du SDK plus prise en charge, -100 erreur interne (contactez l’assistance développeurs Play en indiquant le nom de l’API dans l’objet).
Pour le premier groupe, utilisez une nouvelle tentative bornée avec backoff exponentiel et une condition de sortie, et faites remonter le message actionnable (mettre à jour le Play Store, vérifier la connectivité). Pour le second groupe, basculez immédiatement vers votre expérience par défaut et journalisez — une tempête de nouvelles tentatives sur APP_NOT_OWNED ne fait que consommer la batterie. Les builds installés en sideload y aboutiront toujours, ce qui explique aussi pourquoi les tests exigent le faux gestionnaire documenté plutôt qu’un APK installé à la main.
Étape 8 — Garder une posture de données défendable
Deux questions de données différentes se confondent ici. La bibliothèque cliente Play Age Signals ne collecte ni ne partage elle-même de données avec des tiers ; le Play Store traite les signaux sur l’appareil. Ce que vous faites des valeurs après lecture vous appartient entièrement, et c’est là que se situe l’exposition aux règles : déclarez-le dans votre politique de confidentialité, limitez la rétention à ce qu’exige l’expérience adaptée à l’âge, et ne réutilisez pas les signaux pour la publicité, le profilage ou l’analytique — les conditions limitent leur usage à la fourniture d’expériences adaptées à l’âge, et un usage détourné entraîne la résiliation de l’accès à l’API et met l’app elle-même en danger.
Google recommande également d’appeler l’API en parallèle de l’API Play Integrity pour que la réponse ne puisse pas être falsifiée par un build modifié. C’est un ajout peu coûteux au moment de l’intégration, et une reprise très onéreuse après un incident.
Contrôle avant publication : statut d’accès géré pour les trois états, bornes nulles jamais traitées comme « mineures », tranches personnalisées figées selon vos règles produit, notification de changement significatif portée par une personne nommée, classifications des SKU d’achat intégré définies pour le Texas, erreurs réessayables bornées, politique de confidentialité mise à jour, Play Integrity pris en compte. Huit points, dont aucun ne sera vérifié par le store à votre place.
Sources : documentation de l’API Play Age Signals sur developer.android.com (présentation, intégration, réponses, gestion des erreurs) et aide de la Play Console sur les projets de loi américains relatifs aux stores d’applications, toutes deux consultées le 23/10/2026. Google Play ne publie ni seuils d’application des règles ni déterminations juridiques par application ; aucune n’est déduite ici.
Vous gérez des comptes développeur à grande échelle ? Nous prenons en charge le volet opérationnel.
Nous avons bien reçu votre message et vous répondrons sous 24 heures.
← Retour à la modification