APIs en Android: Datos y Google Play

El desarrollo de aplicaciones Android modernas depende en gran medida de la capacidad de interactuar con servicios externos y el propio sistema operativo. En el centro de esta interacción se encuentran las Interfaces de Programación de Aplicaciones (APIs). Pero, ¿qué significa realmente usar una API en Android y cómo impacta tanto la funcionalidad de tu app como su distribución?

En esencia, una API actúa como un contrato que permite que dos sistemas de software se comuniquen entre sí. En el contexto de una aplicación Android, esto puede significar varias cosas, desde acceder a funcionalidades del dispositivo proporcionadas por el propio sistema Android (las APIs de la plataforma Android) hasta conectarse a servicios web remotos para obtener o enviar datos.

Uso de APIs para la Recuperación de Datos

Una de las aplicaciones más comunes de las APIs en Android es la recuperación de datos desde fuentes externas, como bases de datos alojadas en servidores remotos. Tu aplicación envía una solicitud a una URL específica proporcionada por el servicio API, y este servicio responde con los datos solicitados.

Estos datos se reciben típicamente en formatos estructurados que son fáciles de procesar por la aplicación. Los formatos más habituales son JSON (JavaScript Object Notation) y XML (Extensible Markup Language), aunque ocasionalmente también se pueden recibir en formato de texto plano.

Para manejar estas comunicaciones y procesar los datos, los desarrolladores Android suelen utilizar bibliotecas predefinidas. Estas bibliotecas contienen el código necesario para realizar tareas como enviar solicitudes HTTP, manejar respuestas y parsear (analizar y convertir) los datos JSON o XML en objetos que la aplicación pueda usar. Al importar estas bibliotecas, los desarrolladores pueden implementar rápidamente la lógica de comunicación sin tener que escribir todo desde cero.

Las APIs de Google Play Developer

Además de las APIs para interactuar con servicios de terceros o el sistema operativo, Google proporciona un conjunto poderoso de APIs específicamente para desarrolladores que publican y gestionan sus aplicaciones en Google Play Console. Estas son las APIs de Google Play Developer, basadas en servicios web REST.

Si bien muchos desarrolladores pueden gestionar sus apps completamente a través de la interfaz web de Google Play Console, estas APIs se vuelven especialmente útiles para aquellos que manejan un gran volumen de aplicaciones, APKs, o necesitan automatizar tareas relacionadas con publicaciones, informes o la gestión de compras y suscripciones.

El paquete de APIs de Google Play Developer te permite concentrarte en el diseño y desarrollo de tu app, reduciendo el tiempo y el esfuerzo en la administración de versiones y fichas, incluso al expandirte a nuevos mercados. Incluye varias APIs clave:

• API de Publishing: Permite automatizar la distribución de apps. Funciones como subir nuevas versiones (APKs/AABs), lanzar apps a diferentes segmentos (alfa, beta, producción), y crear/modificar fichas de Google Play Store (texto, gráficos localizados, capturas de pantalla) se realizan mediante 'ediciones'. Las ediciones permiten agrupar cambios de forma transaccional, confirmándolos todos a la vez.
• API de Subscriptions and In-App Purchases: Para administrar el catálogo de suscripciones y productos dentro de la app, y recuperar detalles de compras individuales (estado del pedido, carga útil del desarrollador, etc.) usando el nombre del paquete, ID del producto/suscripción y el token de compra. A diferencia de la API de Publishing, los cambios con esta API entran en vigor al instante.
• API de Reporting: Proporciona acceso programático a datos y métricas a nivel de app para informes y análisis internos. Incluye datos de Android Vitals como tasas de fallos y ANR.
• API de Reply to Reviews: Permite ver y responder comentarios de usuarios de versiones de producción directamente desde tus propias herramientas de soporte (como sistemas CRM). Solo muestra opiniones con comentarios.
• API de Permissions: Automatiza la gestión de permisos de acceso a tu cuenta de desarrollador en Play Console, útil para añadir/quitar usuarios del equipo.
• API de Voided Purchases: Proporciona una lista de pedidos (suscripciones y compras únicas) que han sido anulados por el usuario (reembolso, cancelación, contracargo, etc.). Esto es crucial para implementar sistemas de revocación y mantener la equidad, especialmente en juegos.

Prácticas Recomendadas al Usar las APIs de Google Play Developer

Google sugiere seguir ciertas prácticas para optimizar el uso de estas APIs:

• API de Publishing: Limita la frecuencia de actualizaciones. No publiques versiones alfa/beta a diario; las de producción deben ser aún menos frecuentes.
• API de Subscriptions and In-App Purchases: Almacena información de suscripción en tu propio servidor seguro para evitar llamadas API innecesarias. Usa la API solo para tokens nuevos o cuando recibas notificaciones en tiempo real (RTDN) que indiquen cambios. No consultes la API con frecuencia solo para comprobar el estado de la suscripción.
• API de Reporting: Ten en cuenta los límites de cuota (generalmente 10 consultas/segundo) y solicita una extensión si es necesario.
• API de Reply to Reviews: Recuerda que solo accede a comentarios de versiones de producción y solo a opiniones que incluyan texto (no solo calificaciones).
• API de Voided Purchases: Utiliza esta API para identificar compras anuladas y revocar el acceso a los productos correspondientes en tu app, creando una experiencia más justa.

La Importancia del Nivel de API Objetivo (targetSdkVersion)

Más allá de las APIs de servicios web, cada aplicación Android debe especificar un nivel de API objetivo (`targetSdkVersion`) en su archivo de manifiesto. Este nivel indica con qué versión del sistema operativo Android se probó tu aplicación y para la cual está diseñada principalmente. Configurar un `targetSdkVersion` alto es crucial porque asegura que tu aplicación se beneficia de las mejoras de seguridad, privacidad y rendimiento introducidas en las versiones más recientes de Android, al tiempo que sigue siendo compatible con versiones anteriores (hasta el `minSdkVersion` especificado).

Google Play tiene políticas estrictas sobre el nivel de API objetivo que las aplicaciones deben cumplir para poder publicarse y estar disponibles para los usuarios. Estas políticas cambian con el lanzamiento de nuevas versiones de Android.

Requisitos Actuales y Futuros del Nivel de API Objetivo en Google Play

Google Play exige que tanto las aplicaciones nuevas como las actualizaciones de aplicaciones existentes cumplan con ciertos niveles mínimos de API objetivo para garantizar una experiencia segura y de calidad para los usuarios.

*Se puede solicitar una extensión hasta el 1 de noviembre de 2024.

Si tu aplicación existente tiene un nivel de API objetivo por debajo del requerido (actualmente API 33 para la mayoría, pero API 34 para nuevas apps/actualizaciones desde agosto 2024), dejará de ser visible y descargable para nuevos usuarios en dispositivos con versiones de Android más recientes que el nivel objetivo de tu app. Esto se debe a que la app no está diseñada para cumplir con los estándares de seguridad y calidad de los sistemas operativos más nuevos.

¿Qué hacer para Cumplir?

• Apps Nuevas: Deben apuntar al nivel de API más reciente requerido (API 34 a partir de agosto de 2024).
• Actualizaciones de Apps Existentes: También deben apuntar al nivel de API más reciente requerido (API 34 a partir de agosto de 2024).
• Apps Existentes con Target Bajo: Si no planeas actualizar el nivel de API, la app solo estará disponible para nuevos usuarios en dispositivos con versiones de Android iguales o inferiores al target de tu app. Si planeas actualizar pero necesitas más tiempo, puedes solicitar una extensión (generalmente hasta noviembre).

Preguntas Frecuentes sobre el Nivel de API Objetivo

Tengo una app en Google Play con target API 31 o inferior (Wear OS 29 o inferior) que no planeo actualizar. ¿Qué opciones tengo?

Para seguir sirviendo a tus usuarios existentes, no necesitas hacer nada. Sin embargo, tu app no estará disponible en Google Play Store para nuevos usuarios en dispositivos con un SO Android más reciente que el target de tu app. Solo estará disponible para usuarios con dispositivos ejecutando un SO con un nivel de API igual o inferior al de tu app. Si planeas actualizar tu app a un target API más alto y necesitas más tiempo más allá del 31 de agosto de 2024, puedes solicitar una extensión para seguir distribuyendo a todos los usuarios hasta el 1 de noviembre de 2024. El formulario de extensión estará disponible en Play Console.

¿Dónde puedo encontrar el formulario de extensión?

En la página de estado de políticas en Play Console. Solo las apps no conformes recibirán advertencias y mensajes en la bandeja de entrada de Play Console. El formulario de extensión está disponible a través de la página de detalles de la advertencia o problema.

Tengo apps que ya no quiero publicar en Google Play. ¿Qué puedo hacer?

Puedes anular la publicación de tu app a través de Google Play Console. Consulta el Centro de Ayuda para instrucciones detalladas.

¿Cómo afectará esta actualización a los usuarios que ya descargaron mi app previamente?

Los usuarios que ya instalaron la app desde Google Play no se verán afectados. Podrán seguir descubriendo, reinstalando y usando la app en cualquier versión del SO Android que tu app soporte.

¿Impactará esto en los niveles de descarga de mi app?

Puede impactar tus niveles de descarga si los nuevos usuarios en dispositivos con versiones de SO Android más recientes no pueden descubrir o descargar tu app desde Google Play.

¿Cuál será la experiencia del usuario si visita un enlace profundo a la página de la tienda, pero la app tiene target API 31 o inferior?

Google Play informará al usuario que "esta app no está disponible para instalar en su dispositivo porque fue hecha para una versión anterior de Android".

En resumen, las APIs son herramientas esenciales en el desarrollo Android, desde la conexión con servicios externos para obtener datos hasta la interacción con las potentes APIs proporcionadas por Google Play para gestionar y distribuir tu aplicación. Cumplir con las políticas de nivel de API objetivo de Google Play es fundamental para asegurar que tu aplicación siga siendo accesible para una amplia audiencia en las versiones más recientes y seguras del sistema operativo Android.

Si quieres conocer otros artículos parecidos a APIs en Android: Datos y Google Play puedes visitar la categoría Desarrollo.