KappS Base de conocimiento · Blog

API Google Play Age Signals en 2026: tutorial paso a paso sobre rangos de edad, aprobaciones de cambios significativos y

Blog Tutorial

La verificación de edad ha pasado de la app a la tienda. La ley SB 2420 de Texas ya está en vigor, el ECA Digital de Brasil empezó a devolver señales de edad el 17 de marzo de 2026, y Google Play ahora ofrece a los desarrolladores una respuesta que antes tenían que adivinar: ¿qué edad tiene este usuario? La API Play Age Signals (beta) es la puerta del lado del cliente a esa respuesta. Este tutorial sigue el orden de integración que evita tener que rehacerlo todo.

Una idea que conviene aclarar primero: Google Play no exige el uso de la API. Las leyes imponen obligaciones a las apps que se distribuyen en esas jurisdicciones; Google proporciona las herramientas y deja la decisión de cumplimiento en tus manos. Deja constancia de esa decisión: un registro de auditoría vale más que el recuerdo de un hilo de Slack.

Paso 1 — Entiende qué cambió realmente en 2026

Tres datos con fecha, todos de la documentación oficial de Google, definen el alcance:

  • Texas. La App Store Accountability Act (SB 2420) está en vigor después de que un tribunal federal de apelaciones suspendiera la orden judicial preliminar emitida en diciembre de 2025. Para los usuarios elegibles, Google Play devuelve señales de edad para las cuentas creadas después del 28 de mayo de 2026, y se prometen más actualizaciones antes de las leyes de verificación de edad en otros estados de EE. UU. (Ayuda de Play Console).
  • Brasil. Desde el 17 de marzo de 2026, la API devuelve señales de edad para los usuarios de Brasil según los requisitos del ECA Digital (Descripción general de las señales de edad).
  • Reparto de obligaciones. La tienda verifica, los padres aprueban, y el desarrollador debe incorporar los rangos de edad y el estado de aprobación parental para los cambios significativos, y notificar a la tienda cuando se produzca un cambio significativo. Las propias preguntas frecuentes de Play dicen claramente que no exige la API Age Signals: las leyes exigen experiencias adecuadas para la edad.

En la práctica, eso significa que la API resuelve la parte más difícil (no puedes verificar una fecha de nacimiento por tu cuenta sin recopilar datos de identidad que preferirías no tener) y te deja la parte que sí controlas: qué hace la app de forma distinta para una franja de 13 a 15 años frente a una de 18 o más.

Paso 2 — Añade la dependencia y respeta los límites de la superficie

La biblioteca cliente es com.google.android.play:age-signals, y Google recomienda la última versión, 0.0.4. Los formatos compatibles son teléfonos, plegables y tablets con Android 6.0 (nivel de API 23) o superior. Añádela al módulo de la app:

  • implementation 'com.google.android.play:age-signals:0.0.4'

Hay dos restricciones fáciles de pasar por alto. Primera: se trata de una API del lado del cliente y en tiempo de ejecución; las señales de edad se obtienen mientras la app está abierta, no se envían a un backend, así que cualquier control del lado del servidor debe basarse en lo que la app obtuvo y en cómo decida transmitirlo. Segunda: al usar la API aceptas sus términos de servicio y te comprometes a cumplir las políticas para desarrolladores de Google Play.

Paso 3 — Pide acceso antes de pedir la edad

Llamar primero a checkAgeSignals() es el error clásico. Debes resolver el estado de compartición mediante requestAgeSignalsAccess(activity), que devuelve uno de tres estados, y cada uno exige una interfaz distinta:

  • COMPARTIDO — se pueden leer las señales de edad. Abarca a un adulto que verificó o autodeclaró su edad en una región elegible de uso compartido automático, y a un menor supervisado cuyo progenitor compartió la edad.
  • NOT_SHARED: el usuario o su progenitor ha rechazado. Se aplica tu experiencia alternativa; no vuelvas a preguntar en bucle.
  • VERIFICATION_REQUIRED — en los estados de EE. UU. aplicables, el usuario debe verificar en Play Store antes de que exista cualquier señal. Envíalo allí y mantén la solicitud idempotente al regresar.

El comportamiento varía según la región por diseño. Donde la elección es obligatoria (por ejemplo, la UE, el Reino Unido y Brasil), los usuarios eligen Preguntar antes de compartir, Compartir siempre o No compartir nunca; con Preguntar antes de compartir, Play muestra un aviso integrado dentro de la app. En los estados de EE. UU. donde aplica, no hay ningún aviso dentro de la app: Play Store se encarga de la verificación y las llamadas devuelven SHARED o VERIFICATION_REQUIRED. En las cuentas supervisadas, los padres gestionan el uso compartido en la app Family Link. Si un usuario descarta el aviso, Play se lo vuelve a mostrar unas cuantas veces y luego lo suprime; por eso bloquear de forma estricta el estado NOT_SHARED es una decisión de producto, no un comportamiento técnico por defecto.

Paso 4 — Lee los campos de respuesta sin malinterpretar null

checkAgeSignals() devuelve los campos que determinan la lógica de tu ramificación (referencia de respuesta):

  • ageLower / ageUpper — límites inclusivos del rango del usuario. Los rangos predeterminados son 0-12, 13-15, 16-17 y 18+. ageUpper es nulo para el rango superior abierto.
  • ageRangeSource — TIER_A declarado por el propio usuario; TIER_B gestionado por el padre o tutor; TIER_C evaluado mediante tarjeta de crédito, correo electrónico, evaluación con selfi, identificación oficial o identificación fiscal; TIER_D identificación oficial más evaluación con selfi, o identificación digital. Trata el nivel como una calificación de confianza y regístralo junto a la rama que elegiste.
  • significantChangeStatus / significantChangeApprovalDate — APPROVED, PENDING, DECLINED o null cuando la jurisdicción no aplica.
  • installId: asignado a las instalaciones supervisadas, se usa para los avisos de aprobación de apps revocadas.

La trampa: los límites null no significan "menor". Ambos límites vuelven null para un adulto verificado, y también vuelven null cuando el estado es NOT_SHARED o VERIFICATION_REQUIRED. Si tu código asigna "null" a "restringido", bloquearás a adultos que pagan. Ramifica primero según el estado y luego según los límites, y trata los límites null como "desconocido, usa el nivel predeterminado" salvo que el estado indique lo contrario.

Paso 5 — Configura rangos de edad personalizados en Play Console si tu producto los necesita

Los rangos predeterminados rara vez coinciden con una regla real de producto. En la página Señales de edad de Play Console, la pestaña Rangos de edad personalizados admite hasta tres edades mínimas; las edades mínimas deben distar al menos dos años entre sí y pueden cambiarse una vez al año. Si estableces una edad mínima de 15, un usuario de 0 a 14 recibe ageLower=0, ageUpper=14, mientras que un usuario de 15 o más solo recibe ageLower=15. Si estableces 13 y 17, obtienes tres rangos: 0-12, 13-16 y 17+.

Como el cambio es anual, decide los rangos según las reglas de tu producto y los compromisos de tu ficha de la tienda antes de guardar. Reajustar más adelante es una solicitud de cambio, no un ajuste de configuración.

Paso 6 — Configurar los cambios significativos y las clasificaciones por edad de las compras dentro de la app

El "cambio significativo" lo defines tú, no Google. Cuando hagas uno —una nueva función social, un cambio en el uso compartido de datos, una nueva vía de compra—, notifícalo a Play en la página de señales de edad de Play Console; no se requiere una nueva versión de la app. Después, los padres aprueban o rechazan, y tú lees el resultado a través de significantChangeStatus. Play declara que no revocará el acceso a la app ni la desactivará cuando un padre rechace: la consecuencia la defines tú, y la vía de notificación para aprobaciones revocadas pasa por installId.

Texas añade una vía aparte para el dinero: los productos dentro de la app pueden necesitar su propia clasificación por edad, distinta de la clasificación de contenido de la app. Puedes configurarla en Play Console o a través de la Publishing API, y Play la muestra en el flujo de aprobación de compras para los usuarios de Texas en Play Billing. Trata la clasificación del SKU como parte de la lista de verificación del lanzamiento, no como algo secundario: un flujo de compra que la omite es el tipo de carencia que aparece como un hallazgo de cumplimiento en lugar de como un fallo.

Paso 7 — Trata los códigos de error como dos grupos, no como once casos

La tabla de errores se divide en realidad en dos grupos. Reintentables: -1 API no disponible, -2 Play Store no instalada, -3 red, -4 Play Services no instalados, -5 no se puede vincular al servicio, -6 Play Store desactualizada, -7 Play Services desactualizados, -8 error transitorio del cliente. No reintentables: -9 app no instalada desde Google Play, -10 versión del SDK ya no compatible, -100 error interno (contacta con el soporte para desarrolladores de Play e incluye el nombre de la API en el asunto).

Para el primer grupo, usa un reintento acotado con retroceso exponencial y una condición de salida, y muestra el mensaje accionable (actualiza Play Store, comprueba la conectividad). Para el segundo grupo, pasa de inmediato a tu experiencia predeterminada y registra el error: una tormenta de reintentos sobre APP_NOT_OWNED solo consume batería. Las compilaciones instaladas por sideload siempre acabarán ahí, y por eso las pruebas necesitan el gestor simulado documentado en lugar de un APK instalado a mano.

Paso 8 — Mantén la postura de datos defendible

Aquí se confunden dos preguntas distintas sobre datos. La propia biblioteca cliente de Play Age Signals no recopila ni comparte datos con terceros; Play Store procesa las señales en el dispositivo. Lo que hagas con los valores después de leerlos es enteramente tuyo, y ahí es donde reside la exposición ante las políticas: decláralo en tu política de privacidad, limita la retención a lo que necesita la experiencia adecuada para la edad y no reutilices las señales para publicidad, elaboración de perfiles ni analíticas; los términos restringen su uso a ofrecer experiencias adecuadas para la edad, y el mal uso cancela el acceso a la API y pone en riesgo la propia app.

Google también recomienda llamar a la API junto con la API Play Integrity para que la respuesta no pueda falsificarse con una compilación manipulada. Es una adición económica si ya estás integrando, y una adaptación costosa después de un incidente.

Comprobación previa al envío: estado de acceso gestionado para los tres estados, límites nulos que nunca se tratan como "menores", bandas personalizadas fijadas según las reglas de tu producto, notificación de cambios significativos a cargo de una persona designada, clasificaciones de SKU de compra dentro de la app definidas para Texas, errores reintentables acotados, política de privacidad actualizada, Play Integrity valorado. Ocho puntos que la tienda no verificará por ti.

Fuentes: documentación de la API Play Age Signals en developer.android.com (descripción general, integración, respuestas, gestión de errores) y la ayuda de Play Console sobre los próximos proyectos de ley de tiendas de apps de EE. UU., ambas consultadas el 23/10/2026. Google Play no publica umbrales de aplicación de políticas ni determinaciones legales por app; aquí no se infiere ninguna.

¿Gestionas cuentas de desarrollador a escala? Nosotros nos encargamos de la parte operativa.

Haz clic para elegir un archivo · clic derecho → Pegar, o pulsa Ctrl/⌘+V para pegar una captura de pantalla

También puedes arrastrar un archivo a este cuadro.

Respondemos al correo que nos proporciones. Tus datos se quedan con KappS.

✔ Enviado

Hemos recibido tu mensaje y responderemos en un plazo de 24 horas.


← Volver a editar