In diesem Dokument wird beschrieben, wie Sie Alterssignale mithilfe der Play Age Signals API anfordern.
Mit dem Play Age Signals SDK 0.0.4 wird eine Architektur mit zwei Funktionen eingeführt, die Anfragen zu Altersinformationen vereinfacht und unser Modell unterstützt, das auf der Nutzerauswahl basiert. So fordern Sie Alterssignale an:
Rufen Sie die Methode requestAgeSignalsAccess(Activity) auf, die ageSignalsStatus zurückgibt. Der Wert von ageSignalsStatus kann SHARED, NOT_SHARED oder VERIFICATION_REQUIRED sein.
- Wenn
ageSignalsStatus == NOT_SHARED: Ihre App erhält keine Alterssignale in der API-Antwort. - Wenn
ageSignalsStatus == SHARED: Rufen Sie die MethodecheckAgeSignals()auf. Wenn der Nutzer oder das Elternteil zugestimmt hat, die Alterssignale zu teilen, erhalten Sie diese als Teil der API-Antwort und können entscheiden, wie Sie mit der Antwort umgehen möchten. - Wenn
ageSignalsStatus == VERIFICATION_REQUIRED: Das Alter des Nutzers ist unbekannt und der Nutzer befindet sich in einer anwendbaren Gerichtsbarkeit oder Region, in der die Altersbestätigung und die Weitergabe von Alterssignalen obligatorisch sind. Wenn du in diesen Regionen ein Alterssignal von Google Play erhalten möchtest, bitte den Nutzer, den Play Store aufzurufen, um seinen Status zu klären.
Die Methode requestAgeSignalsAccess(Activity) gibt je nachdem, ob die obligatorische Weitergabe des Alters in einer Region gilt, unterschiedliche Werte zurück:
- Bei berechtigten Nutzern in US-Bundesstaaten, in denen App-Shops gesetzlich dazu verpflichtet sind, Entwicklern bestätigte Altersangaben zur Verfügung zu stellen, wird die In-App-Aufforderung nicht ausgelöst.
Stattdessen werden Nutzer aufgefordert, den Altersnachweis zu erbringen oder die Elternaufsicht einzurichten, wenn sie die Google Play Store App aufrufen. Verwenden Sie den Wert von
ageSignalsStatus, um den Status des Altersnachweises zu ermitteln:- Wenn der Nutzer den Altersnachweis erbracht hat oder die Elternaufsicht aktiv ist, lautet der Wert von
ageSignalsStatusSHARED. - Wenn der Nutzer sein Alter noch nicht bestätigt oder die Elternaufsicht eingerichtet hat, ist der Wert von
ageSignalsStatusVERIFICATION_REQUIRED. Weitere Informationen finden Sie unter Änderungen bei Google Play aufgrund anstehender App-Shop-Gesetze für Nutzer in bestimmten US-Bundesstaaten.
- Wenn der Nutzer den Altersnachweis erbracht hat oder die Elternaufsicht aktiv ist, lautet der Wert von
- Für Nutzer in anderen Regionen, in denen die Altersfreigabe auf der Entscheidung des Nutzers oder der Eltern basiert:
- Wenn die Einstellung des Nutzers Vor dem Weitergeben fragen lautet, wird die Aufforderung in der App angezeigt. Wenn der Nutzer der Weitergabe seines Alters zustimmt, ist der Wert von
ageSignalsStatusSHARED, andernfallsNOT_SHARED. - Wenn die Einstellung des Nutzers Immer teilen lautet, wird die In-App-Aufforderung nicht angezeigt und der Wert von
ageSignalsStatusistSHARED. - Wenn die Einstellung des Nutzers Nie teilen lautet, wird die In-App-Aufforderung nicht angezeigt und der Wert von
ageSignalsStatusistNOT_SHARED. - Bei Nutzern mit Elternaufsicht können Eltern in den Einstellungen der Family Link App festlegen, ob das Alter ihres Kindes weitergegeben werden soll. Wenn die Eltern das Alter teilen möchten, ist der Wert von
ageSignalsStatusSHARED, andernfallsNOT_SHARED.
- Wenn die Einstellung des Nutzers Vor dem Weitergeben fragen lautet, wird die Aufforderung in der App angezeigt. Wenn der Nutzer der Weitergabe seines Alters zustimmt, ist der Wert von
Informationen zur Weitergabe von Informationen zur Altersgruppe bei Google Play, einschließlich der Aufforderung in der App und der Freigabeeinstellungen, findest du unter Weitergabe von Informationen zur Altersgruppe bei Google Play.
Im folgenden Beispiel wird gezeigt, wie Sie Alterssignale anfordern:
Kotlin
// 1. Initialize the AgeSignalsManager (usually in onCreate or class initialization)
val ageSignalsManager = AgeSignalsManagerFactory.create(applicationContext)
// 2. Request or check for age signals access.
// Passing the current Activity allows the Play Store to render the age sharing prompt UI if required.
val accessRequest = AgeSignalsAccessRequest.builder()
.setActivity(this)
.build()
ageSignalsManager.requestAgeSignalsAccess(accessRequest)
.addOnSuccessListener { accessResult ->
if (accessResult.ageSignalsStatus() == AgeSignalsStatus.SHARED) {
// The user (or parent) has agreed to share age range, or is in an eligible auto-share region.
// Retrieve the actual age signals.
retrieveAgeSignals(ageSignalsManager)
} else {
// Age signals are not shared (user didn't share age range, parent rejected the request, or not eligible).
}
}
.addOnFailureListener { exception ->
// Handle API/Play Store connection and system errors
handleAgeSignalsError(exception)
}
private fun retrieveAgeSignals(manager: AgeSignalsManager) {
// 3. Perform the actual age signals query once sharing is active.
manager.checkAgeSignals(AgeSignalsRequest.builder().build())
.addOnSuccessListener { ageSignalsResult ->
val installId = ageSignalsResult.installId()
val ageLower = ageSignalsResult.ageLower()
val ageUpper = ageSignalsResult.ageUpper()
val significantChangeDate = ageSignalsResult.significantChangeApprovalDate()
val ageRangeSource = ageSignalsResult.ageRangeSource()
if (ageLower != null) {
if (ageUpper != null) {
// The user is in a specific closed age range [ageLower, ageUpper] (e.g. [13, 15])
} else {
// The user is in the highest open-ended age band [ageLower, null] (e.g. [18, null])
}
} else {
// Both bounds are null: The user is not sharing their age
}
}
.addOnFailureListener { exception ->
handleAgeSignalsError(exception)
}
}
Java
// 1. Initialize the AgeSignalsManager (usually in onCreate or class initialization)
AgeSignalsManager ageSignalsManager = AgeSignalsManagerFactory.create(getApplicationContext());
// 2. Request or check for age signals access.
// Passing the current Activity allows the Play Store to render the age sharing prompt UI if required.
AgeSignalsAccessRequest accessRequest = AgeSignalsAccessRequest.builder()
.setActivity(this)
.build();
ageSignalsManager.requestAgeSignalsAccess(accessRequest)
.addOnSuccessListener(accessResult -> {
Integer status = accessResult.ageSignalsStatus();
if (status == AgeSignalsStatus.SHARED) {
// The user (or parent) has agreed to share age range, or is in an eligible auto-share region.
// Retrieve the actual age signals.
retrieveAgeSignals(ageSignalsManager);
} else {
// Age signals are not shared (user didn't share age range, parent rejected the request, or not eligible).
}
})
.addOnFailureListener(exception -> {
// Handle API/Play Store connection and system errors
});
private void retrieveAgeSignals(AgeSignalsManager manager) {
// 3. Perform the actual age signals query once sharing is active.
manager.checkAgeSignals(AgeSignalsRequest.builder().build())
.addOnSuccessListener(ageSignalsResult -> {
String installId = ageSignalsResult.installId();
Integer ageLower = ageSignalsResult.ageLower();
Integer ageUpper = ageSignalsResult.ageUpper();
Date significantChangeDate = ageSignalsResult.significantChangeApprovalDate();
@AgeRangeSource Integer ageRangeSource = ageSignalsResult.ageRangeSource();
if (ageLower != null) {
if (ageUpper != null) {
// The user is in a specific closed age range [ageLower, ageUpper] (e.g. [13, 15])
} else {
// The user is in the highest open-ended age band [ageLower, null] (e.g. [18, null])
}
} else {
// Both bounds are null: The user is not sharing their age (e.g. they are a verified adult)
}
})
.addOnFailureListener(exception -> {
handleAgeSignalsError(exception);
});
}
Wichtige Punkte zum Code
- Die Methode
requestAgeSignalsAccess(Activity)führt eine blockierende Prüfung der aktuellen Alterssignale und des Status der Freigabe von Alterssignalen des Nutzers durch. - Nachdem du
requestAgeSignalsAccess(Activity)aufgerufen hast, zeigt Google Play eine integrierte In-App-Aufforderung nur für Nutzer ohne Elternaufsicht an. Eltern von Nutzern mit Elternaufsicht können die Einstellungen für die Altersfreigabe in der Family Link App verwalten und so festlegen, ob das Alter ihres Kindes weitergegeben werden soll. - Wenn der Nutzer die Altersfreigabe ablehnt oder schließt, wird die Aufforderung in der App einige Male angezeigt, bevor sie unterdrückt wird.
- Mit der Methode
checkAgeSignals()wird der Wert für Alterssignale in der API-Antwort abgerufen. Diese Methode gibtageRangeSource,ageUpper,ageLowerund andere wichtige Änderungswerte zurück.