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

Si usas la API de Play Age Signals (beta), aceptas las condiciones del servicio y te comprometes a cumplir con todas las políticas para desarrolladores de Google Play. Para solicitar el estado y el rango etario del usuario, llama a la API desde tu app en el tiempo de ejecución. La API de Play Age Signals solo devuelve datos de los usuarios que se encuentran en regiones en las que Play está obligado por ley a proporcionar datos de categorías de edad.

Play devuelve un rango de edad basado en los rangos de edad definidos por las regiones y jurisdicciones aplicables. Las edades predeterminadas que devuelve la API en las jurisdicciones y regiones aplicables son de 0 a 12, de 13 a 15, de 16 a 17 y mayores de 18 años, pero pueden cambiar según los requisitos regionales.

Integra la API de Play Age Signals en tu app

Para integrar la API de Play Age Signals en tu app, agrega la siguiente dependencia al archivo build.gradle de tu app:

implementation 'com.google.android.play:age-signals:0.0.1-beta01'

Solicita indicadores de edad

A continuación, se muestra un ejemplo de cómo realizar una solicitud de indicadores de edad:

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

Google Play almacena los indicadores de edad en el dispositivo para cada usuario. Cuando un usuario con una Cuenta de Google supervisada alcanza una nueva edad, Google Play actualiza automáticamente los indicadores de edad almacenados en caché para ese usuario en un plazo de 2 a 8 semanas después de su cumpleaños.

(Opcional) Recibe rangos de edad personalizados

Los rangos etarios predeterminados que la API devuelve en las jurisdicciones y regiones aplicables son de 0 a 12, de 13 a 15, de 16 a 17 y mayores de 18 años. Estos rangos pueden cambiar en el futuro según los requisitos locales.

Como alternativa, para personalizar los rangos de edad según las edades mínimas de tu app, puedes proporcionar estas edades mínimas en la página Age signals de Google Play Console. La API de Age Signals devuelve los rangos de edad personalizados. Por ejemplo, si proporcionas edades mínimas de 9, 15 y 17 años, un usuario de 14 años se incluiría en el rango de edad de 10 a 15 años. Las edades mínimas deben tener una diferencia de al menos 2 años y se pueden cambiar una vez al año.

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

1. Ve a la página Indicadores de edad en Play Console.
2. En la pestaña Edades mínimas de la app, ingresa hasta tres edades mínimas para tu app.
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 quieres obtener los valores más recientes, solicita una respuesta de la API cuando se abra tu app. Eres responsable de proporcionar experiencias adecuadas para la edad con estos indicadores.

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

Si tu app realiza una solicitud a la API de Play Age Signals (beta) 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

Cuando 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.