Guia de migração do Fit

As APIs Google Fit vão ter suporte até o final de 2026. O Google oferece vários produtos e serviços de saúde e bem-estar para ajudar os usuários a continuar alcançando as metas após a descontinuação.

Atenção:a API Google Fit (incluindo a API REST) só vai ter suporte até o final de 2026. Recomendamos migrar para a API Google Health para integrações baseadas na nuvem ou para a Conexão Saúde para monitoramento de passos e apps para dispositivos móveis.

As diretrizes abaixo mostram para qual serviço migrar com base em como você está usando as APIs Google Fit.

A escolha da API precisa 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 de dados agregados de passos de várias fontes com foco em dispositivos móveis.
App complementar de rastreadores de condicionamento físico API Google Health Plataforma com foco na Web que exige o OAuth para integração do usuário.
Plataforma de Saúde e fitness A API Google Health & Conexão Saúde Use a API Google Health para dados de dispositivos Fitbit/Google e a Conexão Saúde para dados agregados no dispositivo.

Por integração atual

Integração atual Caminho recomendado Disponibilidade
API Fit History e API Fit Session API Google Health Disponível
Leitura de passos em dispositivos móveis (com a API de gravação do Google Fit) Conexão Saúde Disponível
API Fit no Wear OS Recursos de saúde Disponível
API Fitbit Web API Google Health Disponível
Conexão Saúde Mantenha a integração atual ou adicione a API Google Health Disponível

Comparações técnicas

As seções a seguir fornecem uma comparação técnica entre as APIs 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 de servidor para servidor (S2S).

Recurso API Fit (Android/REST) API Google Health
Configuração do projeto Console do Google Cloud Criar projeto 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 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 com foco em dispositivos móveis que leem métricas de dispositivos locais.

Recurso API Fit para Android Conexão Saúde
Registro Console do Google Cloud Declaração de projetos e apps de saúde da Google Play Store
Autenticação OAuth 2.0 obrigatório Nenhum OAuth necessário (permissões no dispositivo)
Armazenamento de dados Focado na nuvem Centrado no dispositivo (no dispositivo)
Público-alvo Desenvolvedores Android legados Desenvolvedores de dispositivos móveis Modern Android
Permissões Escopos do OAuth Permissões de manifesto do Android

Integrações da API Fit

As seções a seguir fornecem orientações sobre como migrar de cada uma das APIs Google Fit. Se a integração também incluir elementos de interface que se conectam ao app Google Fit, consulte as diretrizes de integrações do app Fit para mais orientações.

Apps que usam a API Fit Recording para gravar passos

A API Fit Recording cria assinaturas para permitir que o app solicite armazenamento automatizado de dados do sensor para economizar bateria. 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 gravar passos.

Siga estas etapas para migrar da API Fit Recording:

Tabela 1: etapas de migração da API Fit Recording
Telefone Wear
  1. Para mostrar uma contagem total de passos, adicione a Conexão Saúde ao seu app. O total inclui passos em dispositivos móveis (Android 14 ou mais recente) e passos de outros apps e dispositivos.
  2. Para continuar mostrando dados de passos locais no app, implemente a gravação de dados usando a API de gravação da Conexão Saúde.

Use os Recursos de saúde:

  • PassiveMonitoringClient
  • ExerciseClient

Consulte a documentação sobre os 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:

Tabela 2: etapas de migração da API Fit History
Telefone Wear

Faça a transição para a API Google Health.

Não relevante. 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 do sensor brutos.

Siga estas etapas para migrar da API Sensor:

Tabela 3: etapas de migração da API Fit Sensor
Telefone Wear

Use sensores, API do provedor de localização combinada

Use Recursos de saúde no Wear OS:

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    Ou use SensorManager, FusedLocationProvider

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:

Tabela 4: etapas de migração da API Fit Session
Telefone 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 o app para dispositivos móveis.

Para fluxos de trabalho específicos, é recomendado:

  • Inserir uma sessão: os desenvolvedores precisam usar a Conexão Saúde com o app para dispositivos móveis e inserir um ExerciseSessionRecord ou um SleepSessionRecord de acordo com cada caso.

Apps que usam a API Goals

A API Goals oferece objetivos no app Google Fit que os usuários podem definir para métricas como passos e pontos de frequência cardíaca. A plataforma Fit registra os objetivos e monitora a atividade diária deles usando a API Goals.

Tabela 5: orientações de migração para a API Fit Goals
Telefone 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 :

Tabela 6: etapas de migração da API Fit BLE
Telefone 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 da 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 monitoramento de metas e os objetivos de atividades diárias 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 conecta ao Google Fit para compartilhamento de dados, siga as orientações sobre como 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 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, você pode entrar em contato conosco.

Tabela 7: recomendações para usuários atuais com integrações do app Fit
checkFaça isso closeNão faça isso
Ofereça a Conexão Saúde ou a API Google Health como uma nova opção no app.

Concentre-se nos benefícios do usuário, como dados e insights mais detalhados, privacidade e segurança.

Sincronizar com a Conexão Saúde

Peça aos usuários para se desconectarem do Google Fit.

Desconectar da Conexão Saúde

Novos usuários do app

Para oferecer uma experiência semelhante aos novos usuários do app, recomendamos criar uma integração com a Conexão Saúde ou a API Google Health.

A 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 com foco na Web para dados de dispositivos Fitbit e Google.

Tabela 8: recomendações para novos usuários com integrações do app Fit
checkFaça isso closeNão faça isso
Inclua a Conexão Saúde ou a API Google Health no fluxo de configuração do app. Ofereça o Fit como um app que os usuários podem se conectar quando a Conexão Saúde estiver disponível.