Zum Hauptinhalt springen
Didit erhält 7,5 Mio. $ für die Infrastruktur für Identität und Betrug
Didit
Zurück zum Blog
Blog · 22. November 2026

Play Age Signals API: Integrationsleitfaden v0.0.6 für Android-Apps

Die drei Aufrufe von Play Age Signals 0.0.6 in Kotlin, Entscheidungstabelle für Status, Tiers und Grenzen, Fehler, Migration von 0.0.3 und 0.0.4, Tests und der Start eigener Altersprüfungen.

Von DiditAktualisiert
play-age-signals-api-integration-cover.png

In Kürze

Um die Play Age Signals API heute zu integrieren, fügen Sie com.google.android.play:age-signals:0.0.6 hinzu, rufen Sie requestAgeSignalsAccess mit einer Activity auf und rufen Sie checkAgeSignals nur auf, wenn der Status SHARED ist.[1][2]

  • Lesen Sie das Alter aus ageLower. Die Stufe gibt an, wie das Alter ermittelt wurde, und null ist niemals ein Erwachsener.
  • Das Manifest der Bibliothek 0.0.6 deklariert minSdk 24, obwohl der Leitfaden API 23 angibt.[1][11]
  • Das Signal bleibt in Ihrer App. Wenn Sie eine eigene Altersprüfung benötigen, starten Sie diese ohne das Signal.

Zuletzt überprüft: 22. November 2026 · Keine Rechtsberatung

Dies ist der technische Leitfaden zur Play Age Signals API: Zuerst Android, dann Flutter, React Native, Expo und Unity. Wer betroffen ist und was im Januar 2027 beginnt, lesen Sie unter Google Play Age Signals API: Was sich im Januar 2027 ändert. Google stellt die API bereit und verpflichtet Sie nicht, sie aufzurufen; ein Gesetz kann dies tun.

Jede Klasse, Methode und jedes Enum unten wurde am 22. November 2026 mit den Seiten von Google und der veröffentlichten Bibliothek 0.0.6 abgeglichen; der Kotlin-Code für das Signal lässt sich dagegen kompilieren.

Was Sie benötigen

Die API läuft auf Smartphones, Foldables und Tablets über die Play-Store-App auf dem Gerät.[1][5]

  • Setzen Sie minSdk auf 24 (siehe Warnung).
  • Veröffentlichen Sie über Google Play: Die Bedingungen beschränken die API auf Apps, die über Google Play aktualisiert werden.[5]
  • Öffnen Sie die Seite für Alterssignale in der Play Console: Benutzerdefinierte Altersgrenzen, wesentliche Änderungen und widerrufene Genehmigungen befinden sich dort.[3][8][9]
  • Beantworten Sie das Formular zur Datensicherheit von Play selbst. Google gibt an, dass die Client-Bibliothek keine Daten erfasst und das Formular Ihre Entscheidung ist.[5]

Achtung

Die Einrichtungsseite von Google gibt Android 6.0, API-Level 23 an.[1] Das Manifest in der Bibliothek 0.0.6 deklariert minSdkVersion 24; 0.0.3 und 0.0.4 deklarierten 23.[11] Eine App mit minSdk 23 lässt sich nach dem Upgrade wegen des Manifest-Merges möglicherweise nicht mehr bauen. Die Erhöhung auf 24 ist die einfache Lösung.

  1. Februar 20260.0.3Ein Aufruf, userStatus, fügt DECLARED hinzu.
  2. Juli 20260.0.4Zwei Aufrufe, Tiers ersetzen userStatus.
  3. November 20260.0.6Global, fügt getApplicableAgeFeatures hinzu.
  4. 11. Dezember 2026Alle NutzerGoogles Datum für Antworten an alle.

Bibliotheksversionen aus den Versionshinweisen und dem Banner von Google.[2][4] Bis zu diesem Datum müssen Sie bei einigen Nutzern mit einer fehlenden Antwort rechnen.

Bibliothek hinzufügen

Eine Abhängigkeit.[1] Der Fake-Manager für Tests befindet sich im selben Artefakt.[11]

dependencies {
    implementation("com.google.android.play:age-signals:0.0.6")
}

1getApplicableAgeFeatures (optional)

Ob die Weitergabe für diesen Nutzer verpflichtend ist.

2requestAgeSignalsAccess

Kann eine eigene Aufforderung von Google Play anzeigen.

Status ist SHARED

Ja

3checkAgeSignals

Grenzwerte, Quelle, Änderungsstatus auslesen.

Nein

Kein Alter von Google

Verwenden Sie Ihren altersgerechten Standardwert.

Die Aufrufreihenfolge in 0.0.6.[2]

Schritt 1: Ist das Teilen für diesen Nutzer verpflichtend

Der Aufruf ist optional.[2] features() enthält MANDATORY_SHARING nur für Nutzer in Regionen, deren Gesetze App-Stores dazu verpflichten, Altersinformationen zu teilen, und ist für alle anderen leer.[2]

val manager = AgeSignalsManagerFactory.create(applicationContext)

manager.getApplicableAgeFeatures(ApplicableAgeFeaturesRequest.builder().build())
    .addOnSuccessListener { result ->
        val mandatory = ApplicableAgeFeature.MANDATORY_SHARING in result.features()
        // Use it to word your own screen. It is not an age.
    }
    .addOnFailureListener { error -> handleAgeSignalsError(error) }

Hinweis

Verpflichtend bedeutet, dass das Teilen durch den Nutzer verpflichtend ist. Es sagt nichts darüber aus, wie das Alter ermittelt wurde: Google dokumentiert MANDATORY_SHARING mit TIER_A, TIER_B, TIER_C und TIER_D.[3]

Schritt 2: Zugriff anfordern

Googles Text nennt requestAgeSignalsAccess(Activity); die Methode akzeptiert ein AgeSignalsAccessRequest, das die Activity enthält.[2] Rufen Sie sie dort auf, wo eine Aufforderung akzeptabel ist.

val request = AgeSignalsAccessRequest.builder()
    .setActivity(this)
    .build()

manager.requestAgeSignalsAccess(request)
    .addOnSuccessListener { access ->
        when (access.ageSignalsStatus()) {
            AgeSignalsStatus.SHARED -> readSignals(manager)
            AgeSignalsStatus.NOT_SHARED -> applyGate(AgeGate.NoSignal)
            AgeSignalsStatus.VERIFICATION_REQUIRED -> applyGate(AgeGate.VerifyInPlay)
            else -> applyGate(AgeGate.NoSignal) // UNSPECIFIED or null
        }
    }
    .addOnFailureListener { error -> handleAgeSignalsError(error) }

Was der Nutzer sieht, hängt von Region und Einstellung ab:[2]

NutzerAufforderungStatus
US-Bundesstaat, in dem Stores verifizierte Altersangaben bereitstellen müssen (verifiziert oder beaufsichtigt)KeineSHARED
Ebenso, noch nicht verifiziertKeine in Ihrer App; Play übernimmt dasVERIFICATION_REQUIRED
Andernorts, Vor dem Teilen fragen (Standardeinstellung[14])In-App-Aufforderung von PlaySHARED oder NOT_SHARED
Andernorts, Immer teilenKeineSHARED
Andernorts, Nie teilenKeineNOT_SHARED
Andernorts, beaufsichtigtKeine; die Eltern entscheiden in Family LinkSHARED oder NOT_SHARED

Nach einigen Zurückweisungen zeigt Play die Aufforderung nicht mehr an. Rufen Sie die Methode daher nicht in einer Schleife auf.[2] Wo die Weitergabe verpflichtend ist, ist die Einstellung fest auf Immer teilen gesetzt.[14]

Passen Sie Ihr Age-Gate an das Signal an

Zeigen Sie uns Ihr Age-Gate und Ihre Märkte. Wir zeigen Ihnen, welche Pfade eine eigene Prüfung erfordern und welche nicht.

Demo anfordernKostenlos starten

Schritt 3: Ergebnis auslesen

Jedes Feld kann null sein. Konvertieren Sie es daher einmal und verwenden Sie einen einheitlichen Typ in Ihrer App. Dieses Mapping liest das Alter nur aus den Grenzwerten aus.

sealed interface AgeGate {
    data object NoSignal : AgeGate
    data object VerifyInPlay : AgeGate
    data class Range(
        val lower: Int,
        val upper: Int?,         // null = top band, not "adult"
        val source: Int?,        // AgeRangeSource.TIER_A to TIER_D
        val changeStatus: Int?   // SignificantChangeStatus
    ) : AgeGate {
        fun isAtLeast(age: Int) = lower >= age
    }
}

fun toAgeGate(r: AgeSignalsResult): AgeGate {
    val lower: Int = r.ageLower() ?: return AgeGate.NoSignal
    return AgeGate.Range(
        lower, r.ageUpper(), r.ageRangeSource(), r.significantChangeStatus()
    )
}

private fun readSignals(manager: AgeSignalsManager) {
    manager.checkAgeSignals(AgeSignalsRequest.builder().build())
        .addOnSuccessListener { result -> applyGate(toAgeGate(result)) }
        .addOnFailureListener { error -> handleAgeSignalsError(error) }
}

Die Konstanten für Status, Quelle und Änderung sind Ganzzahlen, wobei 0 UNSPECIFIED ist.[10][11] Behandeln Sie dies in einem else-Zweig. Der Leitfaden 0.0.3 von Google empfahl eine neue Anfrage beim Öffnen der App, da sich Werte ändern können[12]; ein Nutzer kann die Weitergabe später auch deaktivieren.[14]

Hinweis

Dieser Leitfaden empfiehlt außerdem, parallel die Play Integrity API aufzurufen, damit der Aufruf von einem unmanipulierten Build auf einem zertifizierten Gerät stammt.[12] Das Signal ist eine clientseitige Antwort: Vertrauen Sie keiner Altersspanne, die ein modifizierter Client an Ihren Server sendet.

Die Entscheidungstabelle: Status x Quelle x Grenzwerte

Die Standardbereiche sind 0-12, 13-15, 16-17 und 18+.[3] Die letzte Spalte enthält unsere technische Empfehlung, nicht die von Google.

StatusQuelleUntergrenze / ObergrenzeBedeutungWas Ihr Code tut
AusnahmekeinekeineKeine Antwort[7]Erneut versuchen, falls wiederholbar, sonst kein Signal
NOT_SHAREDnullnull / nullNutzer oder Elternteil haben der Weitergabe nicht zugestimmt[2][3]Altersgerechte Standardeinstellung, keine erneute Abfrage
VERIFICATION_REQUIREDnullnull / nullNicht verifiziert, in einer Region, in der Verifikation und Weitergabe verpflichtend sind[2][3]Auf den Play Store verweisen, Standard beibehalten
SHAREDTIER_A13 / 15Nutzer hat Google das Alter mitgeteilt, das möglicherweise bestätigt wurde oder nicht[3]Altersspanne anwenden
SHAREDTIER_A18 / nullEbenso, Altersspanne für Erwachsene[3]Anwenden; Prüfung nur hinzufügen, wenn Gesetz oder Risiko mehr verlangen
SHAREDTIER_B13 / 15Alter wird von einem Elternteil oder Erziehungsberechtigten verwaltet[3]Altersspanne anwenden, Änderungsstatus auslesen
SHAREDTIER_C18 / nullGeprüft über Kreditkarte, E-Mail, Selfie, behördlichen Ausweis oder Steuer-ID[3]Altersspanne anwenden
SHAREDTIER_D18 / nullBehördlicher Ausweis plus Selfie oder eine digitale ID[3]Altersspanne anwenden
SHAREDbeliebignull / beliebigNicht in Googles AntworttabelleAls kein Signal behandeln

Drei Fehlinterpretationen verursachen die meisten Fehler:

  • TIER_A ist nicht „nicht verifiziert“. Ein Erwachsener, der sich mit einer digitalen ID verifiziert hat, das Signal aber freiwillig teilt, wird ebenfalls als TIER_A übermittelt.[3] TIER_C und TIER_D werden nur in Regionen zurückgegeben, in denen eine Altersverifikation gesetzlich vorgeschrieben ist, zum Beispiel in Texas.[3] Die Klassenreferenz bezeichnet TIER_A als „selbst deklariert“; der Antwortleitfaden ist vorsichtiger.[3][10]
  • TIER_B ist kein Alter. Es gibt an, wer es verwaltet. Lesen Sie die Grenzwerte aus.
  • Null-Grenzwerte bedeuten keinen verifizierten Erwachsenen. Ein Kommentar im Java-Beispiel von Google deutet dies an; das Kotlin-Beispiel besagt, dass der Nutzer nicht teilt, und die Antworttabelle stimmt mit dem Kotlin-Beispiel überein.[2][3]

Wann Sie hier aufhören sollten

Wenn die Altersspanne Ihre Frage beantwortet und weder Gesetz noch Risiko mehr verlangen, hören Sie auf. Eine zweite Prüfung bei jedem Nutzer lässt sich nur schwer mit der Datenminimierung vereinbaren, und in Kalifornien ist das Signal der primäre Indikator, es sei denn, Sie verfügen über interne klare und überzeugende Informationen.[15]

Endet ein Zweig ohne Alterssignal, finden Sie die Gestaltung der nächsten Schritte unter Was tun bei NOT_SHARED, TIER_A oder keiner Antwort.

Brauchen Sie eine Antwort für Fälle, in denen das Signal keine liefert

Demo zur Altersschätzung in Ihrer App anfordern: Zuerst Selfie, Ausweisdokument nur bei Grenzfällen.

Demo anfordernKostenlos starten

Benutzerdefinierte Mindestalter

Auf dem Tab „Benutzerdefinierte Altersspannen“ geben Sie bis zu drei Mindestalter ein, die mindestens zwei Jahre auseinanderliegen und einmal im Jahr geändert werden können. Sie überschreiben die Standardantwort.[3]

Festgelegte MindestalterZurückgegebene AltersspannenOberste Spanne
Keine (Standard)0-12, 13-15, 16-17, 18+18 / null
150-14, 15+15 / null
13, 170-12, 13-16, 17+17 / null
11, 13, 150-10, 11-12, 13-14, 15+15 / null

Beispiele aus Googles Antwortleitfaden.[3]

Beispiel

Sie legen 13 und 17 fest. Für einen 25-Jährigen kommt nun 17 / null zurück, genau wie für einen 17-Jährigen. Code, der ein ageUpper von null als erwachsen interpretiert, lässt 17-Jährige in eine Funktion ab 18 zu. Behalten Sie 18 also in Ihrer Liste, wenn Sie ab 18 beschränken. Dokumentierte Grenzwerte enden bei 18[3]: Diese API kann eine Beschränkung ab 21 Jahren nicht beantworten.

Wesentliche Änderungen und widerrufene Genehmigungen

Beide Funktionen sind für beaufsichtigte Nutzer gedacht. Welches Gesetz eine Änderung wesentlich macht, ist Ihre Entscheidung, nicht die von Play[8]; die Bestimmungen der US-Bundesstaaten finden sich in den App Store Accountability Acts.

Sie benachrichtigen Play

Wesentliche Änderung

  • Bis zu 3 Änderungen, bis zu 90 Tage im Voraus, mehr als 2 Tage auseinander
  • Englische Beschreibung erforderlich, wird Eltern wortgetreu angezeigt
  • significantChangeStatus ist APPROVED, PENDING oder DECLINED
  • Ihre App muss die geänderte Funktion einschränken

Kumulativ: Eine Genehmigung deckt alle ausstehenden Änderungen ab[8]

Play benachrichtigt Sie

Widerrufene Genehmigung

  • installId gilt pro Nutzer und Gerät und bleibt nach einem Zurücksetzen nicht erhalten
  • Sie dürfen sie nur für diesen Zweck auf Ihrem Backend speichern
  • Widerrufene IDs erscheinen als CSV in der Play Console
  • Jeder Eintrag wird nach 90 Tagen gelöscht; laden Sie die Liste daher regelmäßig herunter.

Eine ID kann mehr als einmal vorkommen[9]

Sperren Sie bei PENDING und DECLINED die geänderte Funktion, nicht die gesamte App. Der Status ist null für nicht beaufsichtigte Konten und für beaufsichtigte Konten ohne erfasste Änderung.[3]

Fehler und nicht unterstützte Geräte

Fehler treten als AgeSignalsException auf. Google empfiehlt Wiederholungen mit einer begrenzten Anzahl an Versuchen.[7]

// -8 (CLIENT_TRANSIENT_ERROR) to -1 (API_NOT_AVAILABLE) are marked retryable
private val RETRYABLE =
    AgeSignalsErrorCode.CLIENT_TRANSIENT_ERROR..AgeSignalsErrorCode.API_NOT_AVAILABLE
private var attempts = 0

fun handleAgeSignalsError(e: Exception) {
    val code = (e as? AgeSignalsException)?.errorCode
    if (code in RETRYABLE && attempts++ < 3) retryLater()
    else applyGate(AgeGate.NoSignal)
}
CodeKonstanteWiederholenAktion
-1, -6API_NOT_AVAILABLE, PLAY_STORE_VERSION_OUTDATEDJaZur Aktualisierung des Play Store auffordern
-2PLAY_STORE_NOT_FOUNDJaZur Installation oder Aktivierung des Play Store auffordern
-3NETWORK_ERRORJaZur Überprüfung der Verbindung auffordern
-4, -7PLAY_SERVICES_NOT_FOUND, PLAY_SERVICES_VERSION_OUTDATEDJaZur Installation, Aktivierung oder Aktualisierung der Play Services auffordern
-5CANNOT_BIND_TO_SERVICEJaExponentieller Backoff, dann Play Store aktualisieren
-8CLIENT_TRANSIENT_ERRORJaBegrenzte Wiederholungsversuche, dann später versuchen
-9APP_NOT_OWNEDNeinNicht über Google Play installiert: Sideload oder anderer Store
-10SDK_VERSION_OUTDATEDNeinNeuere Bibliothek ausliefern
-11DEVICE_NOT_SUPPORTEDNeinGerätetyp wird nicht unterstützt; neu in 0.0.6[4]
-100INTERNAL_ERRORNeinDer Text von Google schlägt weiterhin begrenzte Wiederholungsversuche vor; der obige Code wiederholt den Versuch nicht

Fehlercode-Referenz von Google.[7] Ein Fehler ist kein Alter: Weichen Sie auf das Standarderlebnis aus.

Migration von 0.0.3 und 0.0.4

Version 0.0.3 liefert weiterhin Antworten, erhält jedoch keine Updates.[12] Der Umstieg von 0.0.3 erfordert ein Neuschreiben des Lesepfads; von 0.0.4 aus ist er gering.

In Ihrem CodeIn 0.0.6Von
checkAgeSignals alleinrequestAgeSignalsAccess zuerst[4]0.0.3
userStatus()Entfallen: ageRangeSource() und significantChangeStatus()[4]0.0.3
VERIFIEDTIER_C oder TIER_D (unsere Auslegung)0.0.3
DECLAREDTIER_A oder TIER_B, falls ein Elternteil es verwaltet (unsere Auslegung)0.0.3
SUPERVISEDTIER_B (unsere Auslegung)0.0.3
SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIEDTIER_B mit PENDING oder DECLINED (unsere Auslegung)0.0.3
UNKNOWN, nullDer Zugriffsstatus: VERIFICATION_REQUIRED oder NOT_SHARED (unsere Auslegung)0.0.3
mostRecentApprovalDate()significantChangeApprovalDate()[4]0.0.3
Zwei Aufrufe, StufenUnverändert; fügen Sie getApplicableAgeFeatures hinzu, falls nützlich[4]0.0.4
FehlerbehandlungFügen Sie DEVICE_NOT_SUPPORTED hinzu[4]Beide
minSdk 23Bibliothek deklariert 24[11]Beide

Google veröffentlicht keine Zuordnung Wert für Wert. Zeilen mit dem Hinweis „unsere Auslegung“ stammen aus dem Vergleich beider Definitionen.[3][12]

Achtung

Die alten Konstanten von AgeSignalsVerificationStatus sind in 0.0.6 weiterhin enthalten, sodass Importe kompilieren, während userStatus() nicht existiert.[11] In 0.0.3 war VERIFIED gleich 0; in 0.0.6 ist 0 UNSPECIFIED.[10][11] Löschen Sie zwischengespeicherte Integer-Werte beim Upgrade.

Testen mit FakeAgeSignalsManager und Lizenztestern

FakeAgeSignalsManager kommuniziert nie mit dem Play Store; laut seiner Referenz ist er auf Unit-Tests und die frühe Entwicklung beschränkt.[32] Injizieren Sie den Manager, damit Sie ihn austauschen können.

val fake = FakeAgeSignalsManager()

// Sharing is mandatory for this user
fake.setNextApplicableAgeFeaturesResult(
    ApplicableAgeFeaturesResult.builder()
        .setFeatures(setOf(ApplicableAgeFeature.MANDATORY_SHARING))
        .build()
)
// Verification still pending in Play
fake.setNextAgeSignalsAccessResult(
    AgeSignalsAccessResult.builder()
        .setAgeSignalsStatus(AgeSignalsStatus.VERIFICATION_REQUIRED)
        .build()
)
// Supervised 13 to 15, change waiting for the parent
fake.setNextAgeSignalsResult(
    AgeSignalsResult.builder()
        .setAgeRangeSource(AgeRangeSource.TIER_B)
        .setAgeLower(13)
        .setAgeUpper(15)
        .setSignificantChangeStatus(SignificantChangeStatus.PENDING)
        .setInstallId("fake_install_id_123")
        .build()
)
// Fails checkAgeSignals
fake.setNextAgeSignalsException(
    AgeSignalsException(AgeSignalsErrorCode.NETWORK_ERROR)
)
  • Decken Sie jeden Status, eine Altersspanne für Minderjährige, eine Altersspanne für Erwachsene, Null-Grenzwerte und einen Fehler pro Aufruf ab (setNextRequestAgeSignalsAccessException und setNextApplicableAgeFeaturesException lassen die anderen beiden fehlschlagen).
  • Führen Sie den Live-Aufruf mit einem Lizenztester durch: Normalerweise erhält eine App, die nicht über Play aktualisiert wurde, APP_NOT_OWNED; Tester können einen Debug-Build per Sideloading installieren.[6]
  • Behalten Sie den Paketnamen identisch mit der Play-App bei und melden Sie sich mit dem Tester-Konto an.[6]

Flutter, React Native, Expo und Unity

Dies sind Community- oder Framework-Pakete, nicht die von Google, und die Nennung stellt keine Empfehlung dar. Prüfen Sie die Bibliotheksversion vor der Auslieferung.

StackGeprüftes PaketBibliothekVor dem Ausliefern beachten
Expoexpo-age-range 58.0.30.0.4Im Web und auf iOS vor Version 26 gibt es lowerBound: 18 zurück, wie bei einem Erwachsenen[17]
React Nativereact-native-play-age-range-declaration 3.0.50.0.4Umfasst auch andere Stores und Apple[19]
Flutterage_range_signals 0.10.10.0.4Ablauf mit zwei Aufrufen, Unterstützung für Lizenztester[18]
Unityunity-play-age-signals0.0.4GPL-3.0; Callbacks können außerhalb des Haupt-Threads laufen[20]

Abgerufen am 22. November 2026 von der jeweiligen Paketseite oder Build-Datei.[17][18][19][20] Unity-Mitarbeiter schrieben im Dezember 2025, dass Unity kein eigenes Plugin veröffentlichen wird.[21]

Ein Paket auf Version 0.0.4 hat kein getApplicableAgeFeatures und kein DEVICE_NOT_SUPPORTED. Wenn Sie diese benötigen, schreiben Sie eine kleine native Bridge. Die Apple-Seite wird in Play Age Signals vs Apple Declared Age Range verglichen.

Nicht protokollieren, teilen oder Profile erstellen

Die Nutzungsbedingungen von Google beschränken die Informationen auf altersgerechte Angebote zur Einhaltung von Gesetzen in der anfragenden App.[5] Die Richtlinie verbietet Werbung, Analysen, Profiling sowie den Verkauf, die Weitergabe oder Übertragung der Daten an Dritte, es sei denn, dies ist gesetzlich zwingend vorgeschrieben.[13]

  • Halten Sie Altersspannen, Stufen und installId aus Protokollen, Absturzberichten und Analyse-Events heraus: Diese Tools gehören meist Dritten.
  • Behalten Sie das Roh-Ergebnis nach Möglichkeit im Arbeitsspeicher und speichern Sie die Funktionsentscheidung statt der Stufe.
  • Hängen Sie das Signal niemals an einen Anbieter von Altersprüfungen an, Didit eingeschlossen.
  • Fordern Sie Nutzer in Kalifornien nicht dazu auf, ihre Altersangaben zu ändern, und teilen Sie kein Signal mit Dritten für Zwecke, die dieses Gesetz nicht vorschreibt.[15]
  • Fragen Sie Ihre Rechtsabteilung, bevor Sie ein Signal für jeden Nutzer anfordern: Das kalifornische Gesetz untersagt Anfragen, die weder dieses noch ein anderes anwendbares Gesetz vorschreibt.[15]

Die Meldung „Play Store besuchen“ gehört also zu VERIFICATION_REQUIRED, nicht zu einem Nutzer in Kalifornien, dessen Altersspanne Sie anzweifeln. Die regionale Seite von Google führt Kalifornien und Brasilien ab Januar 2027 als verpflichtend auf und Alabama mit „Details folgen in Kürze“.[16] Die kalifornischen Pflichten finden Sie im Leitfaden zum Digital Age Assurance Act.

Nach dem Signal: Eigene Prüfung starten

Ihre App entscheidet, dass eine Prüfung erforderlich ist. Die Anfrage enthält einen Workflow und Ihre Benutzer-ID, niemals die Antwort von Google. Rufen Sie Didit von Ihrem Server aus auf, da der API-Schlüssel das Gerät nicht erreichen darf.

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "YOUR_AGE_WORKFLOW_ID",
    "vendor_data": "user-42"
  }'

Die 201-Antwort enthält session_id, session_token und url.[25] Senden Sie nur den Token an die App und starten Sie dann das SDK:[26]

// Once, in Application.onCreate: DiditSdk.initialize(this)

lifecycleScope.launch {
    DiditSdk.state.collect { state ->
        if (state is DiditSdkState.Ready) DiditSdk.launchVerificationUI(this@MainActivity)
    }
}

DiditSdk.startVerification(token = sessionToken) { result ->
    when (result) {
        is VerificationResult.Completed -> refreshAgeDecision() // asks your server
        is VerificationResult.Cancelled -> keepSafeDefault()
        is VerificationResult.Failed -> keepSafeDefault()
    }
}

Das SDK-Ergebnis dient der Benutzeroberfläche. Übernehmen Sie die Entscheidung aus dem signierten Webhook status.updated oder rufen Sie GET /v3/session/{sessionId}/decision/ von Ihrem Server ab.[25][29] Behalten Sie bei Abbruch und Fehlern den sicheren Standardwert bei.

Die Grenzen kennen

Wo das Signal ausreicht, überspringen Sie diesen Schritt. Eine eigene Prüfung setzt sich nicht immer durch. Die Gesetze von Alabama und Utah mit Pflichten ab 2027 nutzen für die geregelten Schutzmaßnahmen die niedrigste Alterskategorie und Brasilien die schützendere Alternative. Dort kann eine Prüfung die Einstufung also nur verschärfen.[22][23][24] Personen, die unter das Recht von Illinois, Texas oder Colorado fallen, benötigen vor einem Selfie den Schritt zur biometrischen Einwilligung, den das native SDK 4.10.0 oder neuer anzeigen kann.[28] Klären Sie mit Ihrer Rechtsabteilung, welche Regelung für Ihre App gilt.

Wie Didit nach dem Signal unterstützt

Didit Age Estimation schätzt ein Alter anhand eines Selfies, mit Lebenderkennung im selben Schritt, und gibt nicht an, wer die Person ist. Ein Workflow kann einen von Ihnen festgelegten Grenzbereich an eine Dokumentenprüfung weiterleiten.[27] Age Estimation kostet $0.10 pro Abruf; siehe Preise.

Didit console, age estimation result of a verification: the estimated age from the selfie next to the age on the document

Das Ergebnis der Altersschätzung in der Didit-Konsole (Beispieldaten): die Schätzung aus dem Selfie neben dem Alter auf dem Dokument.

Native SDKs existieren für Android, iOS, React Native und Flutter. Für Unity und andere Engines ist der dokumentierte Weg die WebView-Integration.[31] Oberflächen außerhalb von Google Play werden in Altersverifikations-API: Apps, Web und Stores und auf der Lösungsseite zur Altersverifikation behandelt.

Didit bietet

  • Eine gehostete Altersprüfung mit Selfie, Lebenderkennung und einem optionalen Dokumentschritt
  • Eine Workflow-Option nach ISO/IEC 27566-1, die eine Ja- oder Nein-Entscheidung über das Alter und keine personenbezogenen Daten zurückgibt, ab einem Mindestalter von 13[27]
  • Aufbewahrungsfristen, Schalter für zurückgegebene Daten und ein Löschaufruf[30]

Bleibt bei Ihnen

  • Der Aufruf von Play Age Signals und dessen Ergebnis
  • Welches Recht gilt und ob überhaupt eine Prüfung erforderlich ist
  • Die altersgerechte Standardeinstellung und die endgültige Zugangsentscheidung

Didit hat keine Anbindung für Play Age Signals: Das Signal bleibt in Ihrer App.

Sehen Sie den Fallback-Zweig in Ihrer App laufen

Bringen Sie Ihr Age-Gate, Ihre Märkte und Ihren Stack mit oder erstellen Sie den Workflow selbst.

Demo anfordernKostenlos startenDokumentation lesen

Wichtigste Erkenntnisse

  • Nutzen Sie 0.0.6: optionaler Features-Aufruf, Zugriffsanfrage, dann checkAgeSignals nur bei SHARED.
  • Prüfen Sie den Zugang anhand von ageLower; ein null-Wert bei ageUpper bedeutet die oberste Spanne, und benutzerdefinierte Mindestalter können sie unter 18 verschieben.
  • Null-Grenzwerte, UNSPECIFIED und Fehler bedeuten kein Signal, niemals ein Erwachsener.
  • Das Manifest von 0.0.6 deklariert minSdk 24.
  • Behalten Sie das Signal in Ihrer App und starten Sie jede eigene Prüfung ohne dieses.

Häufig gestellte Fragen

Welche Version der Play Age Signals API sollte ich verwenden?

Nutzen Sie 0.0.6. Sie ist die aktuelle Version, weltweit verfügbar, und laut Google wird sie bis zum 11. Dezember 2026 Antworten für alle Nutzer liefern; 0.0.4 liefert in der Zwischenzeit weiterhin Antworten in ausgewählten Regionen.[2]

Muss ich getApplicableAgeFeatures aufrufen?

Nein, Google kennzeichnet dies als optional. Rufen Sie es auf, wenn sich Ihre eigenen Bildschirme für einen Nutzer unterscheiden sollen, dessen Weitergabe verpflichtend ist.[2]

Was ist der Unterschied zwischen NOT_SHARED und VERIFICATION_REQUIRED?

NOT_SHARED bedeutet, dass Ihre App kein Alterssignal erhält, weil der Nutzer oder ein Elternteil der Weitergabe nicht zugestimmt hat. VERIFICATION_REQUIRED bedeutet, dass das Alter in einer Region nicht verifiziert ist, in der sowohl Verifikation als auch Weitergabe verpflichtend sind, und Google weist Sie an, den Nutzer zum Besuch des Play Store aufzufordern.[2]

Warum sind beide Grenzwerte null?

Die Antwortreferenz liefert Null-Grenzwerte, wenn der Status NOT_SHARED oder VERIFICATION_REQUIRED lautet.[3] Behandeln Sie Null-Grenzwerte als fehlendes Signal und niemals als Erwachsenen.

Warum ist ageUpper für Erwachsene null?

Weil die oberste Altersspanne nach oben offen ist: 18+ liefert ageLower 18 und ageUpper null.[3] Bei benutzerdefinierten Altersstufen kann die oberste Spanne niedriger beginnen. Vergleichen Sie ageLower daher mit Ihrem eigenen Mindestalter.

Kann ich eigene Altersspannen festlegen?

Ja, bis zu drei Mindestalter auf der Seite für Alterssignale in der Play Console, mit mindestens zwei Jahren Abstand, einmal pro Jahr änderbar. Sie überschreiben die Standardspannen.[3]

Wie teste ich, bevor das Gesetz gilt?

Verwenden Sie FakeAgeSignalsManager, um beliebige Status, Spannen oder Fehler zurückzugeben, einschließlich MANDATORY_SHARING. Ein Lizenztester-Konto ermöglicht es einem per Sideload installierten Debug-Build, die Live-API aufzurufen.[6]

Funktioniert es in einer Trusted Web Activity oder einer WebView?

Nicht über Web-Code. Es handelt sich um eine Android-Bibliothek, die mit einer Activity aufgerufen wird, und die von uns geprüften Google-Seiten dokumentieren keine Webschnittstelle. Eine Wrapper-App bräuchte eigenen nativen Code, und die Bedingungen von Google beschränken die Informationen auf die anfragende App.[2][5]

Gibt es ein Plugin für Unity, Flutter oder React Native?

Es gibt Community- und Framework-Pakete. Die von uns am 22. November 2026 geprüften Pakete deklarieren 0.0.4, daher fehlt ihnen getApplicableAgeFeatures. Mitarbeiter von Unity gaben im Dezember 2025 an, dass Unity kein eigenes Plugin veröffentlichen wird.[17][18][19][20][21]

Kann ich das Ergebnis auf meinem Server speichern?

Die Seiten von Google beschreiben ausdrücklich das Speichern von installId in Ihrem Backend für Widerrufsbenachrichtigungen. Behalten Sie im Übrigen nur das kleinste Ergebnis, das Ihre rechtliche Pflicht erfordert, innerhalb Ihrer eigenen Systeme und niemals in Analysediensten, Werbung oder bei einem Drittanbieter, es sei denn, das Gesetz verlangt dies zwingend.[9][13]

Quellen

  1. Play Age Signals API (Beta) verwenden, Android Developers, aktualisiert am 19. November 2026.
  2. Alterssignale anfordern, Android Developers, aktualisiert am 18. November 2026.
  3. Antworten auf Alterssignale verstehen, Android Developers, aktualisiert am 18. November 2026.
  4. Play Age Signals Versionshinweise, Android Developers, aktualisiert am 19. November 2026.
  5. Play Age Signals Übersicht und Nutzungsbedingungen, Android Developers, aktualisiert am 18. November 2026.
  6. Integration der Play Age Signals API (Beta) testen, Android Developers, aktualisiert am 19. November 2026.
  7. Fehlercode-Referenz der Play Age Signals API, Android Developers, aktualisiert am 18. November 2026.
  8. Google Play über wesentliche Änderungen benachrichtigen, Android Developers, aktualisiert am 4. September 2026.
  9. Widerrufene App-Genehmigungen prüfen, Android Developers, aktualisiert am 4. September 2026.
  10. AgeRangeSource-Referenz, Android Developers, aktualisiert am 18. November 2026.
  11. com.google.android.play:age-signals, Google Maven; Bibliotheksmanifeste und Klassen der Versionen 0.0.3, 0.0.4 und 0.0.6, eingesehen am 22. November 2026.
  12. Play Age Signals API verwenden, Version 0.0.3, Android Developers, aktualisiert am 23. Oktober 2026.
  13. Age Signals API und Richtlinie für Nutzerdaten, Google Play Console-Hilfe.
  14. Über die Weitergabe von Altersspannen bei Google Play, Google Play-Hilfe.
  15. AB 1856, Chapter 184, Statutes of 2026, California Legislative Information; ändert Civil Code 1798.500 bis 1798.504.
  16. Regionale altersbezogene Schutzmaßnahmen bei Play, Android Developers, aktualisiert am 18. November 2026.
  17. Expo AgeRange, Expo-Dokumentation; Paket expo-age-range 58.0.3.
  18. age_range_signals, pub.dev, Version 0.10.1 vom 6. Oktober 2026.
  19. react-native-play-age-range-declaration, GitHub, Version 3.0.5.
  20. unity-play-age-signals, GitHub, aktualisiert am 4. August 2026.
  21. Play Age Signals API Support, Unity Discussions, Antwort von Unity-Mitarbeitern vom Dezember 2025.
  22. Code of Alabama 8-19K-9 (HB 161), Alabama Legislature.
  23. Utah Code 13-76-202, Utah Legislature; Entwicklerpflichten ab 6. Mai 2027.
  24. Decreto 12.880 vom 18. März 2026, Art. 25, Planalto, Brasilien.
  25. Sitzung erstellen, Didit-Dokumentation.
  26. Android SDK, Didit-Dokumentation.
  27. Übersicht zur Altersschätzung, Didit-Dokumentation.
  28. Biometrische Einwilligung, Didit-Dokumentation.
  29. Webhooks, Didit-Dokumentation.
  30. Datenaufbewahrung, Didit-Dokumentation.
  31. Übersicht zu nativen SDKs, Didit-Dokumentation.
  32. Referenz zu FakeAgeSignalsManager, Android Developers, aktualisiert am 18. November 2026.

Liefern Sie die drei Aufrufe aus, testen Sie jede Zeile der Tabelle und belassen Sie das Signal dort, wo die Google-Bedingungen es vorsehen: in Ihrer App. Fügen Sie für die Pfade, die es nicht abdecken kann, eine Altersschätzung als eigene Prüfung hinzu.

Prüfung für Nutzer ohne Signal hinzufügen

Fordern Sie eine Demo der Altersschätzung in Ihrer App an oder erstellen Sie einen Workflow und starten Sie noch heute eine Sitzung.

Demo anfordernKostenlos starten

Infrastruktur für Identität und Betrugsprävention.

Eine API für KYC, KYB, Transaktionsüberwachung und Wallet-Screening. In 5 Minuten integriert.

Lass dir diese Seite von einer KI zusammenfassen