As APIs Google Fit estão descontinuadas e serão encerradas no final de 2026. O Google oferece vários produtos e serviços de saúde e bem-estar para ajudar seus usuários a continuar alcançando as metas após a descontinuação.
Atenção:a API Google Fit (incluindo a API REST) terá suporte apenas até o final de 2026. Recomendamos migrar para a API Google Health para integrações baseadas na nuvem ou para o Conexão Saúde para rastreamento de passos e apps mobile-first.
As diretrizes abaixo mostram para qual serviço migrar com base em como você está usando as APIs Google Fit.
Caminhos de migração recomendados
A escolha da API deve ser baseada no tipo de aplicativo e nas necessidades específicas de dados.
Por tipo de aplicativo
| Tipo de aplicativo | Caminho recomendado | Motivo principal |
|---|---|---|
| App de monitoramento de passos | Conexão Saúde | Leitura focada em dispositivos móveis de dados agregados de etapas de várias fontes. |
| App complementar para trackers de condicionamento físico | API Google Health | Plataforma centrada na Web que exige OAuth para integração de usuários. |
| Plataforma de saúde e fitness | A API Google Health e o Conexão Saúde | Use a API Google Health para dados de dispositivos Fitbit/Google e o Conexão Saúde para dados agregados no dispositivo. |
Pela integração atual
| Integração atual | Caminho recomendado | Disponibilidade |
|---|---|---|
| Google Fit (Android e API REST) | API do Google Health | Disponível |
| Leitura de passos em dispositivos móveis (com a API Recording do Google Fit) | Conexão Saúde | Disponível |
| API Fit no Wear OS | Recursos de saúde | Disponível |
| API Fitbit Web | API do Google Health | Disponível |
| API Recording em dispositivos móveis | Conexão Saúde | Disponível |
| Conexão Saúde | Manter a integração atual ou adicionar a API Google Health | Disponível |
Comparações técnicas
As seções a seguir oferecem uma comparação técnica entre as APIs do Google Fit, a API Google Health e a Conexão Saúde para ajudar você a escolher o caminho de migração certo.
API Fit x API Google Health
Use esse caminho se o app for uma plataforma baseada na Web ou exigir interações entre servidores (S2S).
| Recurso | API Fit (Android/REST) | API do Google Health |
|---|---|---|
| Configuração do projeto | Console do Google Cloud | Criar um projeto na nuvem do Google Cloud |
| Configuração do OAuth | Tipo de aplicativo Android ou da Web | Tipo de aplicativo da Web |
| Arquitetura de dados | Tipos com prefixo com.google |
Tipos de dados unificados da API Google Health |
| Registro do app | Criar projeto na nuvem do Google Cloud | Criar um projeto na nuvem do Google Cloud e ativar a API Google Health |
API Fit x Conexão Saúde
Use esse caminho para aplicativos Android mobile-first que leem métricas de dispositivos locais.
| Recurso | API Fit para Android | Conexão Saúde |
|---|---|---|
| Registro | Console do Google Cloud | Projeto da Google Play Store e declaração de apps de saúde |
| Autenticação | OAuth 2.0 obrigatório | Nenhum OAuth necessário (permissões no dispositivo) |
| Armazenamento de dados | Centrado na nuvem | Centrado no dispositivo (no dispositivo) |
| Público-alvo | Desenvolvedores do Android legado | Desenvolvedores de dispositivos móveis Modern Android |
| Permissões | Escopos do OAuth | Permissões do manifesto do Android |
Integrações da API Fit
As seções a seguir fornecem orientações sobre a migração de cada uma das APIs do Google Fit. Se a integração também incluir elementos de interface que se conectam ao app Google Fit, consulte as diretrizes de integração do app Fit para mais orientações.
Apps que usam a API Fit Recording para registrar etapas
A API Fit Recording permite que o app solicite o armazenamento automatizado de dados do sensor para economizar bateria criando assinaturas.
Cada assinatura conecta um app Android a um tipo de dado de condicionamento físico ou
fonte de dados específica, e o tipo de dado Step é usado com frequência para registrar etapas.
Siga estas etapas para migrar da API Recording do Fit:
| Smartphone | Wear |
|
Usar os Recursos de saúde:
Consulte a documentação dos Recursos de saúde para saber mais sobre as diferenças entre os dois. |
Apps que usam a API History para ler ou gravar dados no armazenamento de condicionamento físico
A API History permite que o app execute operações em massa no repositório de condicionamento físico. Essas operações incluem leitura, inserção, atualização e exclusão de dados históricos de saúde e bem-estar.
Siga estas etapas para migrar da API History:
| Smartphone | Wear |
|
Não aplicável. Use a Conexão Saúde no app para dispositivos móveis, não no wearable. |
Apps que usam a API Sensor para mostrar dados de condicionamento físico em tempo real
A API Sensor permite ler dados do sensor brutos no app em tempo real. A API Sensor faz o seguinte:
- Lista as fontes de dados disponíveis no dispositivo e em dispositivos complementares.
- Registra listeners para receber dados brutos do sensor.
- Cancela o registro dos listeners para que eles não recebam mais dados brutos de sensor.
Siga estas etapas para migrar da API Sensor:
| Smartphone | Wear |
|
Usar os Recursos de saúde no Wear OS:
|
Apps que usam a API Session para fornecer resumos de atividades
As sessões representam um intervalo de tempo em que os usuários realizam uma atividade de condicionamento físico.
A API Session permite que o app crie sessões no armazenamento de condicionamento físico.
Siga estas etapas para migrar da API Session:
| Smartphone | Wear |
|
Iniciar/parar: não relevante. O aplicativo monitora o estado das sessões em andamento internamente. Leitura/gravação: Faça a transição para a API Google Health. |
Iniciar/parar: use os Recursos de saúde (ExerciseClient). Leitura/gravação: use a Conexão Saúde com seu app para dispositivos móveis. Para fluxos de trabalho específicos, é recomendado:
|
Apps que usam a API Goals
As metas são objetivos no app Google Fit que os usuários podem definir para métricas como passos e Pontos cardio. A plataforma Fit registra os objetivos e monitora a atividade diária deles usando a API Goals.
| Smartphone | Wear |
| Nenhuma API de substituição disponível. | Nenhuma API de substituição disponível. |
Apps que usam a API BLE
O app pode encontrar dispositivos Bluetooth de baixa energia (BLE) disponíveis e inserir dados do sensor na plataforma Google Fit usando a API BLE.
Siga estas etapas para migrar da API BLE:
| Smartphone | Wear |
| Use as APIs Bluetooth do Android diretamente. | Use as APIs Bluetooth do Android diretamente. |
Recursos descontinuados
Os recursos a seguir não têm uma substituição direta de API. Use as APIs padrão do Android recomendadas:
- API Sensor: use o framework Android Sensors ou a API Fused Location Provider para dados brutos em tempo real.
- API Goals: nenhuma API de substituição disponível. Gerencie o acompanhamento de metas e os objetivos de atividade diária na lógica do aplicativo.
- API Bluetooth de baixa energia (BLE): use as APIs Bluetooth do Android diretamente para se comunicar com o hardware.
Integrações do app Fit
Se o app se conectar ao Google Fit para compartilhamento de dados, siga as orientações sobre migrar usuários atuais e novos para a Conexão Saúde ou a API Google Health nestas seções:
Usuários atuais do app
Se a interface do seu app incluir uma maneira de os usuários se conectarem ao Google Fit (ou se o app estiver incluído na lista de apps compatíveis com o Google Fit), você poderá continuar mantendo a integração do app Fit para os usuários atuais.
Vamos manter esta seção atualizada com informações sobre quando descontinuar a integração do app Fit e quais são as melhores opções para manter a experiência do usuário. Enquanto isso, entre em contato com nossa equipe.
| checkO que fazer | fecharNão faça isso |
| Ofereça o Conexão Saúde ou a API Google Health como uma nova opção no seu app.
Foque nos benefícios para o usuário, como dados e insights mais avançados, privacidade e segurança.
|
Peça aos usuários para se desconectarem do Google Fit.
|
Novos usuários do app
Para oferecer uma experiência semelhante aos novos usuários do seu app, recomendamos criar uma integração com o Health Connect ou a API Google Health.
O Conexão Saúde oferece acesso a novas fontes e tipos de dados para proporcionar uma experiência mais rica aos usuários, com dados armazenados com segurança no dispositivo. A API Google Health oferece uma plataforma focada na Web para dados de dispositivos Fitbit e Google.
| checkO que fazer | fecharNão faça isso |
| Inclua a Conexão Saúde ou a API Google Health no fluxo de configuração do app. | Oferecer o Google Fit como um app que os usuários podem conectar quando a Conexão Saúde estiver disponível. |