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 die Mindestalter Ihrer App anpassen, indem Sie diese Mindestalter für Ihre App auf der Seite Signale für das Alter in der Google Play Console angeben. Die zurückgegebenen Altersgruppen überschreiben die Standard-API-Antwort. Wenn du beispielsweise die Mindestalter 9, 15 und 17 angibst, fällt ein 14-jähriger Nutzer in die Altersgruppe 10–15.

Wenn Sie die Standardaltersgruppen anpassen möchten, die von der Age Signals API zurückgegeben werden, können Sie Mindestalter für Ihre App angeben:

1. Rufen Sie in der Play Console die Seite Altersangaben auf.
2. 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.
3. Klicken Sie auf Speichern.

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.

Beispielantworten für Nutzer in Brasilien

In Brasilien kann userStatus nur DECLARED und UNKNOWN sein.

Wenn ein Nutzer sein Alter angegeben 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.

Der Nutzerstatus kann sich von UNKNOWN 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.

Für einen verifizierten Nutzer erhalten Sie 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.

Bei einem 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 wäre 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 wäre 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 Play Age Signals API-Anfrage stellt und der Aufruf fehlschlägt, erhält Ihre App einen Fehlercode. Diese Fehler können aus verschiedenen Gründen auftreten, z. B. wenn die Play Store App veraltet ist.

Strategie für Wiederholungen

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.