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 Altersfreigabe bereitzustellen.

Play gibt eine Altersgruppe basierend auf den Altersgruppen zurück, die von der anwendbaren Gerichtsbarkeit und den anwendbaren Regionen definiert werden. Die Standardalter, die von der API in den entsprechenden Gerichtsbarkeiten und Regionen zurückgegeben werden, sind 0–12, 13–15, 16–17 und 18+. Diese können sich jedoch je nach regionalen Anforderungen ändern.

Play Age Signals API in Ihre App einbinden

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.1-beta01'

Altersangaben anfordern

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

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

Altersangaben werden von Google Play für jeden Nutzer auf dem Gerät gespeichert. Wenn ein Nutzer mit einem Google-Konto mit Elternaufsicht in eine neue Altersgruppe wechselt, aktualisiert Google Play die zwischengespeicherten Altersangaben für diesen Nutzer automatisch innerhalb von 2 bis 8 Wochen nach dem Geburtstag des Nutzers.

Optional: Benutzerdefinierte Altersgruppen erhalten

Die Standardaltersgruppen, die von der API in den entsprechenden Gerichtsbarkeiten und Regionen zurückgegeben werden, sind 0–12, 13–15, 16–17 und 18+. Diese können sich in Zukunft je nach lokalen Anforderungen ändern.

Alternativ können Sie die Altersgruppen an das Mindestalter Ihrer App anpassen, indem Sie dieses Mindestalter für Ihre App in der Google Play Console auf der Seite Altersangaben angeben. Die Age Signals API gibt die angepassten Altersgruppen zurück. Wenn Sie beispielsweise die Mindestalter 9, 15 und 17 angeben, fällt ein 14-jähriger Nutzer in die Altersgruppe „10–15“. Die Mindestalter müssen mindestens 2 Jahre auseinanderliegen und können einmal jährlich geändert werden.

Wenn Sie die von der Age Signals API zurückgegebenen Altersgruppen anpassen möchten, 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 Mindestalter für die App bis zu drei Mindestalter für Ihre App ein.
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 beim Öffnen Ihrer App eine API-Antwort an. Sie sind dafür verantwortlich, mithilfe dieser Signale altersgerechte Inhalte anzubieten.

API-Fehlercodes behandeln

Wenn Ihre App eine Anfrage an die Play Age Signals API (Beta) 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 Play Store App veraltet ist.

Wiederholungsstrategie

Wenn der Nutzer sich in einer Sitzung befindet, 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.