Notas da versão

26 de maio de 2026

Novos escopos

  • .ecg.readonly para ler dados de eletrocardiograma.
  • .irn.readonly para ler dados de IRN.

Mudanças no nome do escopo

Substituir escopos de leitura/gravação por .writeonly. Os desenvolvedores precisam especificar explicitamente as permissões de leitura e gravação.

  • .activity_and_fitness agora é .activity_and_fitness.writeonly
  • .health_metrics_and_measurements agora é .health_metrics_and_measurements.writeonly
  • .nutrition agora é .nutrition.writeonly
  • .profile agora é .profile.writeonly
  • .settings agora é .settings.writeonly
  • .sleep agora é .sleep.writeonly

Novos tipos de dados

Adicionamos suporte aos seguintes tipos de dados:

  • Atividade e condicionamento físico: active-energy-burned
  • ECG: electrocardiogram
  • Métricas de saúde e medições: core-body-temperature, blood-glucose
  • IRN: irregular-rhythm-notification
  • Nutrição: food, food-measurement-unit, nutrition-log

Novos endpoints

Webhooks

Adição de suporte à seguinte funcionalidade de webhook:

  • Suporte manual a assinaturas quando um assinante é registrado.
  • Suporte a notificações para os tipos de dados activityLevel, bloodGlucose, dailyRespiratoryRate, heartRateVariability, height, hydrationLog, nutritionLog, respiratoryRateSleepSummary, runVo2Max, sedentaryPeriod, timeInHeartRateZone.
  • Suporte para métricas personalizadas, alertas e erros de assinante no console do Google Cloud.
  • Tenta novamente de forma automática as notificações de webhook com falha por até 7 dias se a comunicação com o assinante for perdida.

Atualizações destacadas da documentação

14 de abril de 2026

Novos tipos de dados

  • Atividade e condicionamento físico: swim-lengths-data
  • Métricas de saúde e medições: height

Novos endpoints

Suporte a webhook

  • Criação automática de assinaturas quando um assinante é registrado.
  • Gerenciar manualmente suas assinaturas usando os endpoints project.subscribers
  • Suporte a notificações para os tipos de dados activeZoneMinutes, altitude, bodyFat, caloriesInHeartRateZone, dailyHeartRateVariability, dailyHeartRateZones, dailyOxygenSaturation, dailyRestingHeartRate, dailySleepTemperatureDerivations, distance, exercise, floors, heartRate, sleep, steps, totalCalories e weight.

Recursos adicionais

  • Bibliotecas REST no GitHub: as bibliotecas REST da API Google Health estão disponíveis para todas as bibliotecas de cliente compatíveis incluídas no projeto APIs do Google do GitHub.
  • Suporte ao API Explorer: os endpoints podem ser chamados usando o API Explorer integrado à documentação de referência.
  • Suporte ao OAuth Playground: a API Google Health v4 está listada no OAuth 2.0 Playground, uma ferramenta que permite chamar os endpoints compatíveis com a biblioteca OAuth do Google.

24 de março de 2026

Anúncio do lançamento da API Google Health

A API Google Health é a próxima geração da API Fitbit Web, criada do zero e projetada para nossa valiosa comunidade de desenvolvedores. Esta versão inicial tem como foco alcançar a paridade com a API Web do Fitbit nos tipos de dados mais solicitados, além de adicionar funcionalidades que a comunidade de desenvolvedores pediu. Confira os recursos disponíveis hoje.

Destaques dos principais recursos

  • Configuração simplificada: registre seus projetos e gerencie IDs de cliente OAuth diretamente pelo conhecido console do Google Cloud.
  • Ampla compatibilidade com plataformas: crie com base nas bibliotecas do Google OAuth2 para uma integração perfeita em todas as principais linguagens e plataformas de programação.
  • Acesso a dados simplificado: use novas definições de escopo que consolidam vários tipos de dados em um único escopo fácil de gerenciar.
  • Endpoints consistentes em todos os tipos de dados: tenha uma jornada de programação mais simples com novos endpoints uniformes e suporte a filtros projetados para otimizar a funcionalidade em todos os tipos de dados.
  • Cobertura abrangente de dados: acesse suporte de leitura e gravação em vários tipos de dados.
  • Notificações em tempo real: receba atualizações instantaneamente com suporte aprimorado para webhook, incluindo criação automática de assinaturas e conteúdo de mensagens de notificação mais completo.
  • Suporte padrão para dados intradiários: recupere dados granulares e intradiários por padrão usando o endpoint de lista, eliminando etapas extras.
  • Pacote de documentação completo: comece a usar rapidamente com nossa nova documentação abrangente, incluindo:
    • Guias de primeiros passos, API, migração e solução de problemas
    • Guia de referência completo para REST
    • Nova ferramenta de paridade da API Google Health, exemplo de código e codelab guiado

Tipos de dados compatíveis

Com esse lançamento, você tem acesso a tipos de dados essenciais, garantindo as informações principais necessárias para criar soluções de saúde inovadoras.

Tipos de dados compatíveis com leitura:

  • Atividade e condicionamento físico: minutos na faixa ativa, minutos na faixa ativa, nível de atividade, altitude, calorias nas faixas de frequência cardíaca, VO2 máximo diário, distância, exercício, andares, VO2 máximo de corrida, período sedentário, passos, tempo na faixa de frequência cardíaca, total de calorias, VO2 máximo
  • Métricas de saúde e medições: Gordura corporal, Variabilidade da frequência cardíaca diária, Zonas de frequência cardíaca diária, Saturação de oxigênio diária, Ritmo respiratório diário, Frequência cardíaca em repouso diária, Derivações de temperatura do sono diárias, Frequência cardíaca, Variabilidade da frequência cardíaca, Saturação de oxigênio, Resumo do sono do ritmo respiratório, Peso
  • Identidade: retorna o ID do usuário do Fitbit e o ID do usuário do Google.
  • Localização: dados de GPS com base em um exercício registrado no formato TCX
  • Nutrição: registro de hidratação
  • Perfil: informações básicas do perfil dos usuários.
  • Configurações: configurações de dispositivo e app para dispositivos móveis definidas pelos usuários
  • Sono: registros de sono clássico e por estágios

Tipos de dados que aceitam gravação:

É possível gravar e modificar dados para estes tipos:

  • Atividade e condicionamento físico: exercício
  • Métricas e medições de saúde: gordura corporal, peso
  • Perfil
  • Configurações
  • Sleep

Principais endpoints para interação

Os seguintes endpoints estão disponíveis para gerenciar assinaturas, usuários e dados de saúde e condicionamento físico:

  • users: métodos getIdentity, getProfile, getSettings, updateProfile e updateSettings para gerenciamento de identidade e perfil.
  • users.dataTypes.dataPoints: métodos batchDelete, dailyRollUp, list, patch, reconcile e rollUp para gerenciamento abrangente de tipos de dados.