As APIs Google Fit, incluindo a API REST Google Fit, não estarão mais disponíveis após 30 de junho de 2025. Desde 1o de maio de 2024, os desenvolvedores não podem se inscrever para usar essas APIs.

Para instruções sobre para qual API ou plataforma migrar, acesse o guia de migração do app Conexão Saúde. Para comparar o app Conexão Saúde com as APIs do Google Fit e as APIs da Fitbit Web, acesse o guia de comparação do app Conexão Saúde.

Saiba mais sobre o app Conexão Saúde e como fazer a integração com a API.

Esta página foi traduzida pela API Cloud Translation.

API Reference

Esta referência da API está organizada por tipo de recurso. Cada tipo de recurso tem uma ou mais representações de dados e um ou mais métodos.

Users.dataSources

Para saber mais sobre o recurso Users.dataSources, consulte a página de representação do recurso.

Método	Solicitação HTTP	Descrição
URIs relacionados a https://www.googleapis.com/fitness/v1/users, salvo indicação em contrário
create	`POST /userId/dataSources`	Cria uma nova fonte de dados exclusiva em todas as fontes pertencentes ao usuário. Uma fonte de dados é uma fonte única de dados do sensor. As fontes de dados podem expor dados brutos provenientes de sensores de hardware em dispositivos locais ou complementares. Elas também podem expor dados derivados, criados ao transformar ou mesclar outras fontes de dados. Várias fontes podem existir para o mesmo tipo de dados. Cada ponto de dados em cada conjunto de dados inserido ou lido na API Fitness tem uma fonte de dados associada. Cada fonte de dados produz um fluxo exclusivo de atualizações de conjuntos de dados, com um identificador de fonte exclusivo. Nem todas as alterações na fonte de dados afetam o ID do fluxo de dados. Assim, os dados coletados pelas versões atualizadas do mesmo aplicativo/dispositivo ainda podem ser considerados pertencentes à mesma fonte de dados. As fontes de dados são identificadas por uma string gerada pelo servidor com base no conteúdo da origem que está sendo criada. O campo `dataStreamId` não pode ser definido ao invocar esse método. Ele será gerado automaticamente pelo servidor com o formato correto. Se um `dataStreamId` for definido, ele precisará corresponder ao formato que o servidor geraria. Esse formato é uma combinação de alguns campos da fonte de dados e tem uma ordem específica. Se não for o caso, a solicitação falhará com um erro. A especificação de um DataType que não é de um tipo conhecido (começando com "com.google.") cria um DataSource com um tipo de dados personalizado. Os tipos de dados personalizados só podem ser lidos pelo aplicativo que os criou. Os tipos de dados personalizados estão descontinuados. Use os tipos de dados padrão. Além dos campos incluídos no ID da fonte, é incluído o número do projeto do desenvolvedor autenticado ao criar a fonte. Esse número é ofuscado quando lido por qualquer outro desenvolvedor que leia tipos de dados públicos.
excluir	`DELETE /userId/dataSources/dataSourceId`	Exclui a fonte de dados especificada. A solicitação falhará se a fonte tiver pontos de dados.
get	`GET /userId/dataSources/dataSourceId`	Retorna a fonte de dados especificada.
list	`GET /userId/dataSources`	Lista todas as fontes de dados visíveis para o desenvolvedor usando os escopos OAuth fornecidos. A lista não está completa. O usuário pode ter fontes de dados particulares visíveis apenas para outros desenvolvedores ou chamadas usando outros escopos.
update	`PUT /userId/dataSources/dataSourceId`	Atualiza a fonte de dados especificada. As propriedades `dataStreamId`, `dataType`, `type`, `dataStreamName` e `device`, com exceção de `version`, não podem ser modificadas. As fontes de dados são identificadas pelo `dataStreamId`.

Users.dataSources.dataPointChanges

Para detalhes do recurso Users.dataSources.dataPointChanges, consulte a página de representação do recurso.

Método	Solicitação HTTP	Descrição
URIs relacionados a https://www.googleapis.com/fitness/v1/users, salvo indicação em contrário
list	`GET /userId/dataSources/dataSourceId/dataPointChanges`	Consulta sobre alterações no ponto de dados do usuário para uma determinada fonte de dados.

Users.dataSources.datasets

Para detalhes do recurso "Users.dataSources.datasets", consulte a página de representação do recurso.

Método	Solicitação HTTP	Descrição
URIs relacionados a https://www.googleapis.com/fitness/v1/users, salvo indicação em contrário
excluir	`DELETE /userId/dataSources/dataSourceId/datasets/datasetId`	Executa uma exclusão inclusiva de todos os pontos de dados com horários de início e término que se sobrepõem ao intervalo de tempo especificado pelo ID do conjunto de dados. Para a maioria dos tipos de dados, o ponto de dados inteiro será excluído. Para tipos de dados em que o período representa um valor consistente (como `com.google.activity.segment`) e um ponto de dados abrange um ponto final do conjunto de dados, somente a parte sobreposta do ponto de dados é excluída.
get	`GET /userId/dataSources/dataSourceId/datasets/datasetId`	Retorna um conjunto de dados que contém todos os pontos de dados com horários de início e término sobrepostos ao intervalo especificado entre os horários mínimo e máximo de início do conjunto de dados. Especificamente, qualquer ponto de dados cujo horário de início é menor ou igual ao horário de término do conjunto de dados e cujo horário de término é maior ou igual ao horário de início do conjunto de dados.
patch	`PATCH /userId/dataSources/dataSourceId/datasets/datasetId`	Adiciona pontos de dados a um conjunto de dados. O conjunto de dados não precisa ter sido criado anteriormente. Todos os pontos dentro do conjunto de dados especificado serão retornados com chamadas subsequentes para recuperar esse conjunto. Os pontos de dados podem pertencer a mais de um conjunto de dados. Esse método não usa semântica de patch: os pontos de dados fornecidos são apenas inseridos, sem dados existentes substituídos.

Users.dataset

Para detalhes do recurso Users.dataset, consulte a página de representação do recurso.

Método	Solicitação HTTP	Descrição
URIs relacionados a https://www.googleapis.com/fitness/v1/users, salvo indicação em contrário
agregar	`POST /userId/dataset:aggregate`	Agrega dados de um determinado tipo ou fluxo em buckets divididos por um determinado tipo de limite. Vários conjuntos de dados de diversos tipos e origens podem ser agregados em exatamente um tipo de bucket por solicitação.

Users.sessions

Para detalhes do recurso Users.sessions, consulte a página representação do recurso.

Método	Solicitação HTTP	Descrição
URIs relacionados a https://www.googleapis.com/fitness/v1/users, salvo indicação em contrário
excluir	`DELETE /userId/sessions/sessionId`	Exclui uma sessão especificada pelo ID de sessão fornecido.
list	`GET /userId/sessions`	Lista as sessões criadas anteriormente.
update	`PUT /userId/sessions/sessionId`	Atualiza ou insere uma determinada sessão.