Play Age Signals API (Beta) verwenden

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

(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 können Sie die Standardaltersgruppen an das für Ihre App festgelegte Mindestalter anpassen. Geben Sie dazu auf der Seite „Alterssignale“ in der Google Play Console das Mindestalter für Ihre App an.

1. Rufen Sie in der Play Console die Seite „Alterssignale“ auf.
2. Geben Sie auf dem Tab Benutzerdefinierte Altersgruppen bis zu drei Mindestalter für Ihre App ein. Die Mindestalter müssen mindestens zwei Jahre auseinanderliegen und können einmal jährlich geändert werden.
3. 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 Nutzer im Alter von 0 bis 14 Jahren werden ageLower = 0 und ageUpper = 14 zurückgegeben.
  • Bei einem Nutzer ab 15 Jahren wird ageLower = 15 zurückgegeben.

• Wenn Sie zwei Mindestalter festlegen (13 und 17):

  • Bei einem Nutzer im Alter von 0 bis 12 Jahren werden ageLower = 0 und ageUpper = 12 zurückgegeben.
  • Bei einem Nutzer im Alter von 13 bis 16 Jahren werden ageLower = 13 und ageUpper = 16 zurückgegeben.
  • Bei einem Nutzer ab 17 Jahren wird ageLower = 17 zurückgegeben.

• Wenn Sie drei Mindestalter festlegen (11, 13 und 15):

  • Bei einem Nutzer im Alter von 0 bis 10 Jahren werden ageLower = 0 und ageUpper = 10 zurückgegeben.
  • Bei einem Nutzer im Alter von 11 oder 12 Jahren werden ageLower = 11 und ageUpper = 12 zurückgegeben.
  • Bei einem Nutzer im Alter von 13 oder 14 Jahren werden ageLower = 13 und ageUpper = 14 zurückgegeben.
  • Bei einem Nutzer ab 15 Jahren wird ageLower = 15 zurückgegeben.

Antworten zu Alterssignalen

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 erhalten möchten, fordern Sie eine API-Antwort an, wenn Ihre App geöffnet wird. Sie sind dafür verantwortlich, mithilfe dieser Signale altersgerechte Inhalte anzubieten.

Beispielantworten für Nutzer in Brasilien

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

Für einen Nutzer, der sein Alter angegeben und es für Apps freigegeben hat, erhalten Sie Folgendes:

• userStatus ist AgeSignalsVerificationStatus.DECLARED.
• ageLower ist eine Zahl (z. B. 13).
• ageUpper ist eine Zahl oder null (z. B. 15).
• Die anderen Antwortfelder sind null.

Für einen Nutzer, dessen Alter unbekannt ist, erhalten Sie Folgendes:

• userStatus ist AgeSignalsVerificationStatus.UNKNOWN.
• Die anderen Antwortfelder sind null.

Für einen Nutzer, dessen Alter nicht für Apps freigegeben ist, erhalten Sie Folgendes:

• userStatus ist null.
• Die anderen Antwortfelder sind null.

Der Nutzerstatus kann sich in DECLARED ändern, sobald das Alter des Nutzers freigegeben 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.

Für einen bestätigten Nutzer erhalten Sie Folgendes:

• userStatus ist AgeSignalsVerificationStatus.VERIFIED.
• ageLower ist eine Zahl (z. B. 18).
• ageUpper ist eine Zahl oder null (z. B. null).
• Die anderen Antwortfelder sind null.

Für einen Nutzer mit Elternaufsicht erhalten Sie Folgendes:

• userStatus wäre AgeSignalsVerificationStatus.SUPERVISED.
• ageLower ist 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, bei dem die Genehmigung einer wesentlichen Änderung aussteht, erhalten Sie Folgendes:

• userStatus wäre AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING.
• ageLower ist 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 verarbeiten

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 verschiedene Ursachen haben, z. B. eine veraltete Google Play Store App.

Wiederholungsstrategie

In Situationen, in denen der Nutzer angemeldet ist, empfehlen wir, eine Wiederholungsstrategie mit einer maximalen Anzahl von Versuchen als Abbruchbedingung zu implementieren, damit der Fehler die Nutzererfahrung so wenig wie möglich beeinträchtigt.