Am 17. März 2026 werden Antworten für Nutzer in Brasilien über die Play Age Signals API eingeführt, um die Anforderungen des Digital ECA zu erfüllen. Wir werden Sie rechtzeitig über Gesetze zur Altersüberprüfung in US-Bundesstaaten informieren, die in Utah im Mai 2026 bzw. in Louisiana im Juli 2026 in Kraft treten sollen. API-Antworten für Nutzer in Texas sind aufgrund einer einstweiligen Verfügung eines Bundesbezirksgerichts nicht live.

Play Age Signals API (Beta) verwenden

Wenn Sie die Play Age Signals API (Beta) verwenden, stimmen Sie den Nutzungsbedingungen zu und erklären sich damit einverstanden, alle Google Play-Entwicklerrichtlinien einzuhalten. Wenn Sie den Status und die Altersgruppe des Nutzers anfordern möchten, rufen Sie die API zur Laufzeit über Ihre App auf. Die Play Age Signals API gibt nur Daten für Nutzer in Regionen zurück, in denen Google Play gesetzlich verpflichtet ist, Daten zur Alterskategorie bereitzustellen.

Google Play gibt eine Altersgruppe basierend auf den Altersgruppen zurück, die von der anwendbaren Gerichtsbarkeit und den anwendbaren Regionen definiert werden. Die Standardalter, die die API in den entsprechenden Gerichtsbarkeiten und Regionen zurückgibt, sind 0–12, 13–15, 16–17 und 18+. Es können jedoch auch benutzerdefinierte Altersgruppen zurückgegeben werden. Google Play aktualisiert die im Cache gespeicherten Altersangaben für einen Nutzer automatisch innerhalb von 2 bis 8 Wochen nach dem Geburtstag des Nutzers.

Play Age Signals API in Ihre App einbinden

Die Play Age Signals API wird auf Smartphones, Foldables und Tablets mit Android 6.0 (API‑Level 23) und höher unterstützt. Wenn Sie die Play Age Signals API in Ihre App einbinden möchten, fügen Sie der Datei build.gradle Ihrer App die folgende Abhängigkeit hinzu:

implementation 'com.google.android.play:age-signals:0.0.3'

Altersangaben anfordern

Hier ein Beispiel für eine Anfrage für Altersinformationen:

Kotlin

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

Java

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

Optional: Benutzerdefinierte Altersgruppen erhalten

Die Standardaltersgruppen, die die API in den entsprechenden Gerichtsbarkeiten und Regionen zurückgibt, sind 0–12, 13–15, 16–17 und 18+.

Alternativ kannst du die Standardaltersgruppen an das für deine App festgelegte Mindestalter anpassen, indem du dieses Mindestalter für deine App in der Google Play Console auf der Seite Altersfreigabe angibst.

Rufen Sie in der Play Console die Seite Altersangaben auf.
Geben Sie auf dem Tab Benutzerdefinierte Altersgruppen bis zu drei Mindestalter für Ihre App ein. Die Mindestalter müssen mindestens 2 Jahre auseinanderliegen und können einmal jährlich geändert werden.
Klicken Sie auf Speichern.

Die zurückgegebenen Altersgruppen überschreiben die Standard-API-Antwort. Beispiel:

Wenn Sie in der Google Play Console ein Mindestalter (15) festlegen:
- Bei einem Alter von 0 bis 14 Jahren werden ageLower = 0 und ageUpper = 14 zurückgegeben.
- Bei einem Alter von mindestens 15 Jahren wird ageLower = 15 zurückgegeben.
Wenn Sie zwei Mindestalter festlegen (13 und 17):
- Bei einem Kind im Alter von 0 bis 12 Jahren werden ageLower = 0 und ageUpper = 12 zurückgegeben.
- Bei einem 13- bis 16-Jährigen werden ageLower = 13 und ageUpper = 16 zurückgegeben.
- Bei einem Alter von 17 Jahren oder mehr wird ageLower = 17 zurückgegeben.
Wenn Sie drei Mindestalter festlegen (11, 13 und 15):
- Bei einem Alter von 0 bis 10 Jahren werden ageLower = 0 und ageUpper = 10 zurückgegeben.
- Bei einem 11- oder 12-Jährigen werden ageLower = 11 und ageUpper = 12 zurückgegeben.
- Bei einem 13- oder 14-Jährigen werden ageLower = 13 und ageUpper = 14 zurückgegeben.
- Bei einem Alter von mindestens 15 Jahren wird ageLower = 15 zurückgegeben.

Antworten auf Signale für das Alter

Die Antwort der Play Age Signals API (Beta) enthält die folgenden Felder und Werte. Die Werte können sich ändern. Wenn Sie die neuesten Werte benötigen, fordern Sie eine API-Antwort an, wenn Ihre App geöffnet wird. Sie sind dafür verantwortlich, dass die Nutzung dieser Signale altersgerecht erfolgt.

Antwortfeld	Werte	Beschreibung
`userStatus`	BESTÄTIGT	Google hat das Alter des Nutzers mit einer in wirtschaftlich angemessener Weise Methode wie einem amtlichen Ausweis, einer Kreditkarte oder einer Gesichtsaltersschätzung bestätigt. Wenn `userStatus` gleich `VERIFIED` ist, können Sie die anderen Felder ignorieren. Verwenden Sie `ageLower` und `ageUpper`, um die Altersgruppe des Nutzers zu ermitteln.
	DECLARED	Das Alter des Nutzers wurde vom Nutzer, einem Elternteil oder einem Erziehungsberechtigten angegeben. Verwenden Sie `ageLower` und `ageUpper`, um die Altersgruppe des Nutzers zu ermitteln.
	MIT AUFSICHT	Der Nutzer hat ein Google-Konto mit Elternaufsicht, das von einem Elternteil verwaltet wird, der das Alter des Nutzers festlegt. Verwenden Sie `ageLower` und `ageUpper`, um die Altersgruppe des Nutzers zu ermitteln. Verwenden Sie `mostRecentApprovalDate`, um die letzte genehmigte wesentliche Änderung zu ermitteln.
	SUPERVISED_APPROVAL_PENDING	Der Nutzer hat ein Google-Konto mit Elternaufsicht und sein Elternteil hat eine oder mehrere ausstehende wesentliche Änderungen noch nicht genehmigt. Verwenden Sie `ageLower` und `ageUpper`, um die Altersgruppe des Nutzers zu ermitteln. Verwenden Sie `mostRecentApprovalDate`, um die letzte genehmigte wesentliche Änderung zu ermitteln.
	SUPERVISED_APPROVAL_DENIED	Der Nutzer hat ein Google-Konto mit Elternaufsicht und das Elternteil, das die Elternaufsicht eingerichtet hat, hat die Genehmigung für eine oder mehrere wesentliche Änderungen verweigert. Verwenden Sie `ageLower` und `ageUpper`, um die Altersgruppe des Nutzers zu ermitteln. Verwenden Sie `mostRecentApprovalDate`, um die letzte genehmigte wesentliche Änderung zu ermitteln.
	UNBEKANNT	Das Alter des Nutzers ist unbekannt und der Nutzer befindet sich in einem entsprechenden Rechtssystem oder einer entsprechenden Region. Gilt nur für US-Bundesstaaten:Wenn Sie ein Alters-Signal von Google Play erhalten möchten, bitten Sie den Nutzer, den Play Store aufzurufen, um seinen Status zu ändern.
	`null`	Entweder befindet sich der Nutzer nicht in den anwendbaren Gerichtsbarkeiten und Regionen. Oder der Nutzer gibt sein Alter nicht an Apps weiter.
`ageLower`	0 bis 18	Die (inklusive) Untergrenze der Altersgruppe eines Nutzers mit Elternaufsicht. Verwenden Sie `ageLower` und `ageUpper`, um die Altersgruppe des Nutzers zu ermitteln.
`ageLower`	`null`	`userStatus` ist unbekannt oder `null`.
`ageUpper`	2 bis 18	Die (inklusive) Obergrenze des Altersbereichs eines Nutzers mit Elternaufsicht. Verwenden Sie `ageLower` und `ageUpper`, um die Altersgruppe des Nutzers zu ermitteln.
`ageUpper`	`null`	Entweder wird das `userStatus` mit Elternaufsicht verwaltet und das von den Eltern bestätigte Alter des Nutzers ist über 18 Jahre. Oder die `userStatus` ist unbekannt oder `null`.
`mostRecentApprovalDate`	Datumsstempel	Das `effective from`-Datum der letzten wesentlichen Änderung, die genehmigt wurde. Wenn eine App installiert wird, wird das Datum der letzten wesentlichen Änderung vor der Installation verwendet.
`mostRecentApprovalDate`	`null`	Entweder wird das `userStatus` beaufsichtigt und es wurde keine signifikante Änderung eingereicht. Oder `userStatus` ist bestätigt, unbekannt oder `null`.
`installID`	Eine von Google Play generierte alphanumerische ID.	Eine ID, die von Google Play Installationen von Nutzern mit Elternaufsicht zugewiesen wird und mit der Sie über den Widerruf der App-Genehmigung informiert werden. Lesen Sie die Dokumentation zu widerrufenen App-Genehmigungen.
`installID`	`null`	`userStatus` ist bestätigt, unbekannt oder `null`.

Beispielantworten für Nutzer in Brasilien

In Brasilien kann userStatus nur DECLARED, UNKNOWN oder null sein.

Wenn ein Nutzer sein Alter angegeben und mit Apps geteilt hat, erhalten Sie Folgendes:

userStatus wäre AgeSignalsVerificationStatus.DECLARED.
ageLower wäre eine Zahl (z. B. 13).
ageUpper ist eine Zahl oder null (z. B. 15).
Andere Antwortfelder wären null.

Bei einem Nutzer, dessen Alter unbekannt ist, erhalten Sie Folgendes:

userStatus wäre AgeSignalsVerificationStatus.UNKNOWN.
Andere Antwortfelder wären null.

Für einen Nutzer, dessen Alter nicht an Apps weitergegeben wird, erhalten Sie Folgendes:

userStatus wäre null.
Andere Antwortfelder wären null.

Der Nutzerstatus kann sich in DECLARED ändern, sobald das Alter des Nutzers geteilt werden kann.

Beispielantworten für Nutzer in US‑Bundesstaaten

In den entsprechenden US-Bundesstaaten kann userStatus VERIFIED, SUPERVISED, SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED, UNKNOWN oder null sein.

Ein verifizierter Nutzer erhält Folgendes:

userStatus wäre AgeSignalsVerificationStatus.VERIFIED.
ageLower wäre eine Zahl (z. B. 18).
ageUpper ist eine Zahl oder null (z. B. null).
Andere Antwortfelder wären null.

Für einen Nutzer mit Elternaufsicht erhalten Sie Folgendes:

userStatus wäre AgeSignalsVerificationStatus.SUPERVISED.
ageLower wäre eine Zahl (z. B. 13).
ageUpper ist eine Zahl oder null (z. B. 15).
mostRecentApprovalDate ist ein Java-Datumsobjekt (z. B. 2026-01-01) oder null (wenn keine wesentliche Änderung genehmigt wurde).
installID ist eine von Google Play generierte alphanumerische ID (z. B. 550e8400-e29b-41d4-a716-446655441111).

Für einen Nutzer mit Elternaufsicht, für den die Genehmigung einer wesentlichen Änderung aussteht, erhalten Sie Folgendes:

userStatus wäre AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING.
ageLower wäre eine Zahl (z. B. 13).
ageUpper ist eine Zahl oder null (z. B. 15).
mostRecentApprovalDate ist ein Java-Datumsobjekt (z. B. 2026-01-01) oder null (wenn keine wesentliche Änderung genehmigt wurde).
installID ist eine von Google Play generierte alphanumerische ID (z. B. 550e8400-e29b-41d4-a716-446655441111).

API-Fehlercodes behandeln

Wenn Ihre App eine API-Anfrage an die Play Age Signals API sendet und der Aufruf fehlschlägt, erhält Ihre App einen Fehlercode. Diese Fehler können aus verschiedenen Gründen auftreten, z. B. wenn die Google Play Store App nicht auf dem neuesten Stand ist.

Wiederholungsstrategie

Wenn der Nutzer eine Sitzung hat, empfehlen wir, eine Wiederholungsstrategie mit einer maximalen Anzahl von Versuchen als Endbedingung zu implementieren, damit der Fehler die Nutzerfreundlichkeit so wenig wie möglich beeinträchtigt.

Numerischer Wert des Fehlercodes	Fehlercode	Beschreibung	Wiederholbar
-1	API_NOT_AVAILABLE	Die Play Age Signals API ist nicht verfügbar. Die auf dem Gerät installierte Version der Google Play Store App ist möglicherweise alt. Mögliche Lösung Bitten Sie den Nutzer, den Play Store zu aktualisieren.	Ja
-2	PLAY_STORE_NOT_FOUND	Auf dem Gerät wurde keine Google Play Store App gefunden. Bitten Sie den Nutzer, den Google Play Store zu installieren oder zu aktivieren.	Ja
-3	NETWORK_ERROR	Es wurde kein verfügbares Netzwerk gefunden. Bitte den Nutzer, die Verbindung zu prüfen.	Ja
-4	PLAY_SERVICES_NOT_FOUND	Die Play-Dienste sind nicht verfügbar oder die Version ist zu alt. Bitten Sie den Nutzer, die Play-Dienste zu installieren, zu aktualisieren oder zu aktivieren.	Ja
-5	CANNOT_BIND_TO_SERVICE	Die Bindung an den Dienst im Google Play Store ist fehlgeschlagen. Das kann daran liegen, dass auf dem Gerät eine alte Google Play Store-Version installiert ist oder der Gerätespeicher überlastet ist. Bitten Sie den Nutzer, die Google Play Store App zu aktualisieren. Wiederholen Sie den Vorgang mit exponentiellem Backoff.	Ja
-6	PLAY_STORE_VERSION_OUTDATED	Die Google Play Store App muss aktualisiert werden. Bitten Sie den Nutzer, die Google Play Store App zu aktualisieren.	Ja
-7	PLAY_SERVICES_VERSION_OUTDATED	Die Play-Dienste müssen aktualisiert werden. Bitten Sie den Nutzer, die Play-Dienste zu aktualisieren.	Ja
-8	CLIENT_TRANSIENT_ERROR	Auf dem Clientgerät ist ein vorübergehender Fehler aufgetreten. Implementieren Sie eine Wiederholungsstrategie mit einer maximalen Anzahl von Versuchen als Beendigungsbedingung. Wenn das Problem weiterhin besteht, bitte den Nutzer, es später noch einmal zu versuchen.	Ja
-9	APP_NOT_OWNED	Die App wurde nicht über Google Play installiert. Bitte den Nutzer, deine App bei Google Play herunterzuladen.	Nein
-10	SDK_VERSION_OUTDATED	Die SDK-Version für Altersfreigabe-Signale von Google Play wird nicht mehr unterstützt. Bitten Sie den Nutzer, Ihre App auf eine neuere Version zu aktualisieren, in der eine aktuelle Version des Play Age Signals SDK verwendet wird.	Nein
-100	INTERNAL_ERROR	Unbekannter interner Fehler. Implementieren Sie eine Wiederholungsstrategie mit einer maximalen Anzahl von Versuchen als Beendigungsbedingung. Wenn das Problem weiterhin besteht, bitte den Nutzer, es später noch einmal zu versuchen. Wenn der Vorgang wiederholt fehlschlägt, wenden Sie sich an den Google Play-Entwicklersupport. Geben Sie in der Betreffzeile „Play Age Signals API“ an und fügen Sie so viele technische Details wie möglich hinzu, z. B. einen Fehlerbericht.	Nein

Zurück

Übersicht

Weiter

Über wichtige Änderungen informieren