Google Play Age Signals API in 2026: Ein Schritt-für-Schritt-Tutorial zu Altersgruppen, Genehmigungen wesentlicher Änderungen und
Die Altersverifizierung ist von der App in den Store gewandert. Texas SB 2420 ist jetzt in Kraft, Brasiliens Digital ECA liefert seit dem 17. März 2026 Alterssignale, und Google Play gibt Entwicklern nun eine Antwort, die sie früher raten mussten: Wie alt ist dieser Nutzer? Die Play Age Signals API (Beta) ist die clientseitige Tür zu dieser Antwort. Dieses Tutorial folgt der Integrationsreihenfolge, die eine Neuentwicklung vermeidet.
Eine Einordnung, die Sie zuerst klarstellen sollten: Google Play schreibt die API nicht vor. Die Gesetze erlegen Apps Pflichten auf, die in diesen Jurisdiktionen vertreiben; Google stellt die Werkzeuge bereit und überlässt Ihnen die Compliance-Entscheidung. Schreiben Sie diese Entscheidung auf – ein Audit-Trail ist besser als die Erinnerung an einen Slack-Thread.
Schritt 1 — Verstehen Sie, was sich 2026 tatsächlich geändert hat
Drei datierte Fakten, alle aus der eigenen Dokumentation von Google, definieren den Umfang:
- Texas. Der App Store Accountability Act (SB 2420) ist in Kraft, nachdem ein Bundesberufungsgericht die im Dezember 2025 erlassene einstweilige Verfügung ausgesetzt hat. Für berechtigte Nutzer liefert Google Play Alterssignale für Konten, die nach dem 28. Mai 2026 erstellt wurden, und weitere Updates werden vor den Altersverifizierungsgesetzen in anderen US-Bundesstaaten versprochen (Play Console-Hilfe).
- Brasilien. Seit dem 17. März 2026 liefert die API Alterssignale für Nutzer in Brasilien für Anforderungen nach dem Digital ECA (Age Signals overview).
- Pflichtenverteilung. Der Store verifiziert, die Eltern stimmen zu, und der Entwickler muss Altersbereiche samt Status der elterlichen Zustimmung bei wesentlichen Änderungen aufnehmen und den Store benachrichtigen, wenn eine wesentliche Änderung eintritt. Die eigene FAQ von Play sagt klar, dass sie die Age Signals API nicht vorschreibt – die Gesetze verlangen altersgerechte Erlebnisse.
Praktisch bedeutet das: Die API löst den schwierigsten Teil (Sie können ein Geburtsdatum nicht selbst verifizieren, ohne Identitätsdaten zu erheben, die Sie lieber nicht halten möchten) und überlässt Ihnen den Teil, den Sie tatsächlich kontrollieren: was die App für eine Altersgruppe von 13–15 anders macht als für eine ab 18.
Schritt 2 — Fügen Sie die Abhängigkeit hinzu und beachten Sie die Oberflächenlimits
Die Client-Bibliothek ist com.google.android.play:age-signals, und Google empfiehlt die neueste Version 0.0.4. Unterstützte Formfaktoren sind Smartphones, Foldables und Tablets mit Android 6.0 (API-Level 23) und höher. Fügen Sie sie dem App-Modul hinzu:
implementation 'com.google.android.play:age-signals:0.0.4'
Zwei Einschränkungen werden leicht übersehen. Erstens ist dies eine clientseitige Laufzeit-API: Alterssignale werden abgerufen, während die App geöffnet ist, nicht an ein Backend gepusht, sodass jedes serverseitige Gate davon abhängt, was die App erhalten hat, und dann entschieden werden muss, wie es übermittelt wird. Zweitens akzeptieren Sie durch die Nutzung der API deren Nutzungsbedingungen und verpflichten sich, die Google Play-Entwicklerrichtlinien einzuhalten.
Schritt 3 – Fragen Sie nach dem Zugriff, bevor Sie nach dem Alter fragen
checkAgeSignals() zuerst aufzurufen ist der klassische Fehler. Sie müssen den Freigabestatus über requestAgeSignalsAccess(activity) ermitteln, der einen von drei Zuständen zurückgibt, und jeder verlangt eine andere UI:
GEMEINSAM— Alterssignale dürfen gelesen werden. Dies umfasst einen Erwachsenen, der in einer berechtigten Auto-Share-Region verifiziert oder selbst angegeben hat, und einen beaufsichtigten Minderjährigen, dessen Elternteil das Alter geteilt hat.NOT_SHARED— der Nutzer oder die Erziehungsberechtigten haben abgelehnt. Ihre Fallback-Variante greift; fordern Sie nicht in einer Schleife erneut an.VERIFICATION_REQUIRED— in zutreffenden US-Bundesstaaten muss der Nutzer im Play Store verifizieren, bevor ein Signal existiert. Leiten Sie ihn dorthin und halten Sie die Anfrage bei der Rückkehr idempotent.
Das Regionsverhalten unterscheidet sich bewusst. Wo eine Auswahl erforderlich ist (zum Beispiel EU, UK und Brasilien), wählen Nutzer Vor dem Teilen fragen, Immer teilen oder Nie teilen; bei Vor dem Teilen fragen zeigt Play eine integrierte In-App-Abfrage an. In den zutreffenden US-Bundesstaaten gibt es überhaupt keine In-App-Abfrage – der Play Store übernimmt die Verifizierung, und Aufrufe liefern SHARED oder VERIFICATION_REQUIRED. Bei beaufsichtigten Konten verwalten Eltern das Teilen in der Family-Link-App. Wenn ein Nutzer die Abfrage wegklickt, zeigt Play sie einige Male erneut und blendet sie dann aus – deshalb ist eine harte Sperre bei NOT_SHARED eine Produktentscheidung und kein technischer Standard.
Schritt 4 — Antwortfelder lesen, ohne null falsch zu deuten
checkAgeSignals() gibt die Felder zurück, die Ihre Verzweigungslogik bestimmen (Response-Referenz):
ageLower/ageUpper— inklusive Grenzen der Altersgruppe des Nutzers. Standardgruppen sind 0-12, 13-15, 16-17 und 18+.ageUpperist null für die höchste offene Gruppe.ageRangeSource–TIER_Aselbst angegeben;TIER_Bvon Eltern/Erziehungsberechtigten verwaltet;TIER_Cbewertet über Kreditkarte, E-Mail, Selfie-Bewertung, amtlichen Ausweis oder Steuer-ID;TIER_Damtlicher Ausweis plus Selfie-Bewertung oder Digital ID. Behandeln Sie die Stufe als Vertrauensgrad und protokollieren Sie sie neben dem gewählten Zweig.significantChangeStatus/significantChangeApprovalDate—APPROVED,PENDING,DECLINEDoder null, wenn die Rechtsordnung nicht zutrifft.installId— wird überwachten Installationen zugewiesen und für Mitteilungen über widerrufene App-Genehmigungen verwendet.
Die Falle: Null-Grenzwerte bedeuten nicht „Kind“. Bei einem verifizierten Erwachsenen kommen beide Grenzwerte als null zurück, und sie kommen auch als null zurück, wenn der Status NOT_SHARED oder VERIFICATION_REQUIRED lautet. Wenn Ihr Code „null“ auf „eingeschränkt“ abbildet, sperren Sie zahlende Erwachsene aus. Verzweigen Sie zuerst nach dem Status, dann nach den Grenzwerten, und behandeln Sie Null-Grenzwerte als „unbekannt, Standardstufe verwenden“, sofern der Status nichts anderes sagt.
Schritt 5 — Legen Sie im Play Console benutzerdefinierte Altersstufen fest, wenn Ihr Produkt sie benötigt
Standardbänder entsprechen selten einer echten Produktregel. Auf der Seite Age signals in der Play Console akzeptiert der Tab Custom age ranges bis zu drei Mindestalter; Mindestalter müssen mindestens zwei Jahre auseinanderliegen und können einmal jährlich geändert werden. Legen Sie ein Mindestalter von 15 fest, gibt ein Nutzer im Alter von 0–14 ageLower=0, ageUpper=14 zurück, während ein Nutzer ab 15 nur ageLower=15 zurückgibt. Legen Sie 13 und 17 fest, erhalten Sie drei Bänder: 0–12, 13–16, 17+.
Da die Änderung jährlich erfolgt, legen Sie die Stufen anhand Ihrer Produktregeln und Ihrer Store-Eintrag-Zusagen fest, bevor Sie speichern. Eine spätere Anpassung ist eine Änderungsanfrage, kein Konfigurationstweak.
Schritt 6 — Wesentliche Änderungen und IAP-Altersfreigaben einbinden
Was eine „wesentliche Änderung“ ist, definieren Sie, nicht Google. Wenn Sie eine vornehmen – ein neues Social-Feature, eine Änderung der Datenweitergabe, eine neue Kaufmöglichkeit –, benachrichtigen Sie Play auf der Seite für Alterssignale in der Play Console; eine neue App-Version ist nicht erforderlich. Eltern stimmen dann zu oder lehnen ab, und Sie lesen das Ergebnis über significantChangeStatus aus. Play erklärt, dass es den App-Zugriff nicht widerruft und eine App nicht deaktiviert, wenn ein Elternteil ablehnt: Die Konsequenz liegt in Ihrer Verantwortung, und der Benachrichtigungspfad für widerrufene Genehmigungen läuft über installId.
Texas führt eine separate Spur für Geld ein: In-App-Produkte benötigen möglicherweise eine eigene Altersfreigabe, getrennt von der Inhaltsbewertung der App. Sie können sie in der Play Console oder über die Publishing API festlegen, und Play zeigt sie im Genehmigungsablauf für Käufe bei Texas-Nutzern über Play Billing an. Behandeln Sie die SKU-Altersfreigabe als Teil der Release-Checkliste und nicht als Nachgedanken – ein Kaufablauf, der sie überspringt, ist genau die Art von Lücke, die als Compliance-Feststellung und nicht als Absturz auftaucht.
Schritt 7 — Behandeln Sie die Fehlercodes als zwei Gruppen, nicht als elf Einzelfälle
Die Fehlertabelle besteht eigentlich aus zwei Gruppen. Wiederholbar: -1 API nicht verfügbar, -2 Play Store fehlt, -3 Netzwerk, -4 Play Services fehlen, -5 Bindung an den Dienst nicht möglich, -6 Play Store veraltet, -7 Play Services veraltet, -8 vorübergehender Client-Fehler. Nicht wiederholbar: -9 App nicht über Google Play installiert, -10 SDK-Version wird nicht mehr unterstützt, -100 interner Fehler (wenden Sie sich mit dem API-Namen im Betreff an den Play-Entwicklersupport).
Für die erste Gruppe verwenden Sie einen begrenzten Retry mit exponentiellem Backoff und einer Abbruchbedingung und zeigen Sie die handlungsrelevante Meldung an (Play Store aktualisieren, Konnektivität prüfen). Für die zweite Gruppe fallen Sie sofort in Ihr Standarderlebnis und protokollieren Sie – ein Retry-Sturm bei APP_NOT_OWNED kostet nur Akku. Sideloaded Builds landen immer dort, weshalb Tests auch den dokumentierten Fake-Manager benötigen und nicht eine manuell installierte APK.
Schritt 8 — Die Datenhaltung verteidigungsfähig halten
Hier werden zwei verschiedene Datenfragen verwechselt. Die Play Age Signals Client Library selbst erhebt oder teilt keine Daten mit Dritten; der Play Store verarbeitet die Signale auf dem Gerät. Was Sie nach dem Auslesen mit den Werten tun, liegt ganz bei Ihnen, und genau dort entsteht das Richtlinienrisiko: Legen Sie es in Ihrer Datenschutzerklärung offen, begrenzen Sie die Speicherung auf das, was das altersgerechte Erlebnis benötigt, und verwenden Sie die Signale nicht für Werbung, Profiling oder Analysen zweckentfremdet – die Bedingungen beschränken die Nutzung auf die Bereitstellung altersgerechter Erlebnisse, und Missbrauch beendet den API-Zugriff und bringt die App selbst in Gefahr.
Google empfiehlt außerdem, die API parallel zur Play Integrity API aufzurufen, damit die Antwort nicht durch einen manipulierten Build gefälscht werden kann. Das ist eine günstige Ergänzung, wenn Sie ohnehin integrieren, und eine teure Nachrüstung nach einem Vorfall.
Check vor dem Versand: Zugriffsstatus für alle drei Zustände behandelt, Null-Grenzen nie als „geringfügig“ gewertet, benutzerdefinierte Bänder gegen Ihre Produktregeln fixiert, Benachrichtigung bei wesentlichen Änderungen einer benannten Person zugewiesen, IAP-SKU-Bewertungen für Texas gesetzt, wiederholbare Fehler begrenzt, Datenschutzerklärung aktualisiert, Play Integrity berücksichtigt. Acht Punkte, von denen der Store keinen einzigen für Sie prüft.
Quellen: Play Age Signals API-Dokumentation auf developer.android.com (Überblick, Integration, Antworten, Fehlerbehandlung) und Play Console Help zu kommenden US-App-Store-Gesetzen, beide geprüft am 23.10.2026. Google Play veröffentlicht keine Durchsetzungsschwellen oder rechtlichen Feststellungen pro App; hier werden keine abgeleitet.
Sie verwalten Entwicklerkonten im großen Stil? Wir übernehmen die operative Seite.
Wir haben Ihre Nachricht erhalten und antworten innerhalb von 24 Stunden.
← Zurück zum Bearbeiten