Cómo usar la API de Play Age Signals (beta)

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

(Opcional) Recibe rangos de edad personalizados

Los rangos de edad predeterminados que devuelve la API en las jurisdicciones y regiones aplicables son 0-12, 13-15, 16-17 y 18+.

Como alternativa, para personalizar los rangos de edad predeterminados según las edades mínimas de tu app, puedes proporcionar estas edades mínimas en la página Indicadores de edad de Google Play Console. Los rangos etarios que se devuelvan anularán la respuesta predeterminada de la API. Por ejemplo, si proporcionas edades mínimas de 9, 15 y 17, un usuario de 14 años se incluirá en el rango de edad de 10 a 15 años.

Para personalizar los rangos de edad predeterminados que devuelve la API de Age Signals, puedes proporcionar las edades mínimas de tu app:

1. Ve a la página Indicadores de edad en Play Console.
2. En la pestaña Rangos de edades personalizados, ingresa hasta tres edades mínimas para tu app. Las edades mínimas deben tener una diferencia de al menos 2 años y se pueden cambiar una vez al año.
3. Haz clic en Guardar.

Respuestas de indicadores de edad

La respuesta de la API de Play Age Signals (beta) incluye los siguientes campos y valores. Los valores están sujetos a cambios. Si deseas obtener los valores más recientes, solicita una respuesta de la API cuando se abra tu app. Es tu responsabilidad proporcionar experiencias adecuadas para la edad con estos indicadores.

Ejemplos de respuestas para los usuarios en Brasil

En Brasil, userStatus solo puede ser DECLARED, UNKNOWN o null.

En el caso de un usuario que declaró su edad y la comparte con las apps, recibirías lo siguiente:

• userStatus sería AgeSignalsVerificationStatus.DECLARED.
• ageLower sería un número (por ejemplo, 13).
• ageUpper sería un número o null (por ejemplo, 15).
• Los demás campos de respuesta serían null.

En el caso de un usuario cuya edad se desconoce, recibirías lo siguiente:

• userStatus sería AgeSignalsVerificationStatus.UNKNOWN.
• Los demás campos de respuesta serían null.

En el caso de un usuario cuya edad no se comparte con las apps, recibirás lo siguiente:

• userStatus sería null.
• Los demás campos de respuesta serían null.

El estado del usuario puede cambiar a DECLARED una vez que se pueda compartir su edad.

Ejemplos de respuestas para usuarios de estados de EE.UU.

En los estados de EE.UU. aplicables, userStatus puede ser VERIFIED, SUPERVISED, SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED, UNKNOWN o null.

En el caso de un usuario verificado, recibirás lo siguiente:

• userStatus sería AgeSignalsVerificationStatus.VERIFIED.
• ageLower sería un número (por ejemplo, 18).
• ageUpper sería un número o null (por ejemplo, null).
• Los demás campos de respuesta serían null.

En el caso de un usuario supervisado, recibirás lo siguiente:

• userStatus sería AgeSignalsVerificationStatus.SUPERVISED.
• ageLower sería un número (por ejemplo, 13).
• ageUpper sería un número o null (por ejemplo, 15).
• mostRecentApprovalDate sería un objeto de fecha de Java (por ejemplo, 2026-01-01) o null (si no se aprobó ningún cambio significativo).
• installID sería un ID alfanumérico generado por Play (por ejemplo, 550e8400-e29b-41d4-a716-446655441111).

En el caso de un usuario supervisado con una aprobación de cambio significativo pendiente, recibirías lo siguiente:

• userStatus sería AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING.
• ageLower sería un número (por ejemplo, 13).
• ageUpper sería un número o null (por ejemplo, 15).
• mostRecentApprovalDate sería un objeto de fecha de Java (por ejemplo, 2026-01-01) o null (si no se aprobó ningún cambio significativo).
• installID sería un ID alfanumérico generado por Play (por ejemplo, 550e8400-e29b-41d4-a716-446655441111).

Cómo controlar los códigos de error de la API

Si tu app realiza una solicitud a la API de Play Age Signals y la llamada falla, recibirá un código de error. Estos errores pueden ocurrir por varios motivos, como que la app de Play Store esté desactualizada.

Estrategia de reintentos

En situaciones en las que el usuario está en una sesión, recomendamos implementar una estrategia de reintento con una cantidad máxima de intentos como condición de salida para que el error interrumpa la experiencia del usuario lo menos posible.