Comenzar

Te damos la bienvenida a la API de Google Health.

Esta nueva API aprovecha la autenticación de Google OAuth, lo que proporciona una solución más segura, fácil de usar y escalable para acceder a los datos de salud y administrarlos. Estos son algunos de los beneficios:

  • Seguridad mejorada: La nueva API se alinea con las recomendaciones de seguridad y las prácticas recomendadas actuales de Google para el diseño y la implementación de APIs, lo que reduce el riesgo de vulnerabilidades.

  • Coherencia: La nueva API sigue los principios modernos de diseño de APIs, lo que ofrece una experiencia del desarrollador más coherente y intuitiva.

  • Preparación para el futuro

    • Escalabilidad: La nueva API está diseñada para escalar y satisfacer las demandas futuras, ya que admite una cantidad cada vez mayor de usuarios y tipos de datos.
    • Mantenimiento: Adoptar un enfoque estandarizado facilita el mantenimiento y la actualización de las apps, lo que reduce la deuda técnica.
    • Acceso a nuevas funciones: La migración a la nueva API proporciona acceso a nuevas funciones y funcionalidades a medida que se lanzan, lo que garantiza que las apps se mantengan actualizadas y se beneficien de los avances más recientes.
    • Cumplimiento: La nueva API se mantiene actualizada con los estándares de seguridad y privacidad más recientes de Google, lo que reduce el esfuerzo necesario para mantener el cumplimiento de las apps.
    • Privacidad de los datos: El sistema de OAuth de Google está diseñado para cumplir con diversas reglamentaciones de privacidad de los datos (por ejemplo, el RGPD y la HIPAA), lo que simplifica la carga de cumplimiento para los desarrolladores.

¿Cómo comenzar?

Antes de comenzar el desarrollo, consulta nuestra Lista de tareas para desarrolladores, que proporciona una lista de pasos para ayudarte a lanzar tu integración con la API de Google Health.

La forma en que comiences también dependerá del tipo de desarrollador que seas.

Desarrollador nuevo

Si no tienes experiencia con las APIs de Google o Google Cloud, o necesitas un repaso, la forma más fácil y rápida de comenzar es realizar uno de nuestros codelabs. Ofrecemos codelabs de REST con Visual Studio Code o el Playground de OAuth 2.0, así como un codelab de Python específico de gRPC en el que aprenderás a recuperar stubs de cliente y compilar definiciones de búfer de protocolo.

Codelab de REST (VS Code) Codelab de REST (OAuth 2.0 Playground) Codelab de gRPC (Python)

Desarrollador de Fitbit

Si ya eres desarrollador de la API de Fitbit Web, te recomendamos que primero leas la guía de migración. En él, se destacan todas las diferencias entre la API de Fitbit Web y la API de Google Health, y se proporciona la orientación que necesitas para comenzar a planificar tu migración.

En esta guía, también se destacan las prácticas recomendadas y se incluyen muestras de la IU para ayudar a guiar a los usuarios durante el proceso de reautenticación.

Después de eso, haz el codelab o verifica que tu configuración de Google Cloud esté completa antes de comenzar el desarrollo con una de nuestras guías de tipos de datos.

Lee la guía de migración Completa la configuración de Google Cloud

Elige un protocolo

La API de Google Health admite los protocolos REST y RPC para proporcionar a los desarrolladores una base escalable y de alto rendimiento para la integración de datos de salud.

REST

REST es un enfoque de diseño de APIs basado en conceptos web estándares y formatos legibles para las personas, como JSON. Es especialmente adecuado para crear APIs públicas y aplicaciones web, ya que es compatible con los navegadores y se admite ampliamente. Su principal fortaleza radica en su simplicidad y accesibilidad para los desarrolladores externos.

gRPC

RPC es un sistema de alto rendimiento que usa un formato binario compacto conocido como búferes de protocolo para facilitar la comunicación entre máquinas. Es ideal para microservicios internos, comunicación entre dispositivos móviles y back-end, y actualizaciones en tiempo real debido a su eficiencia y compatibilidad con funciones avanzadas, como la transmisión. RPC es la opción preferida para situaciones de alto rendimiento o cuando se requieren contratos de interfaz estrictos.

Para obtener más información, consulta gRPC vs REST: Understanding gRPC, OpenAPI and REST and when to use them in API design (gRPC vs. REST: Información sobre gRPC, OpenAPI y REST, y cuándo usarlos en el diseño de APIs).

Asistencia de IA y herramientas para desarrolladores

Puedes usar Gemini, el asistente de IA de Google, y las herramientas integradas para desarrolladores en este sitio para acelerar tu flujo de trabajo de la API de Google Health. Mientras navegas, usa el chat de Gemini y la función Explicar código en el Panel de información para resumir guías complejas, aclarar tipos y alcances de datos, o adaptar muestras de código a tu idioma. También puedes probar solicitudes en vivo en el Explorador de APIs y usar las respuestas JSON como contexto de instrucciones para generar lógica de análisis.

Si desarrollas con herramientas potenciadas por IA, como Antigravity, Cursor, Claude Code o agentes personalizados, puedes exportar cualquier página como Markdown o integrar el servidor de MCP de Developer Knowledge para que tu entorno tenga acceso directo a la documentación de la API de Google Health. Usa estos flujos de trabajo para generar código de cliente o solucionar errores. Para obtener más información, consulta Asistencia de IA y herramientas para desarrolladores.

Recursos

Además de ayudarte a comenzar, este sitio incluye recursos integrales para ayudarte con el desarrollo y la migración.

  • Asistencia: ¿Necesitas ayuda? Accede a los foros de la comunidad y a nuestro Issue Tracker público en la página de asistencia.
  • Herramienta de paridad de la API de Google Health: Usa esta herramienta para comparar los extremos y la funcionalidad entre la API de Fitbit Web y la API de Google Health. También incluye un archivo de contexto que puedes usar directamente con un LLM o como parte de un archivo Agents.md en tu herramienta de IA preferida.
  • Referencia de la API: Documentación de referencia completa de REST