Tipos de dados de calorias e energia

A API Google Health fornece tipos de dados que rastreiam as calorias e o gasto energético de um usuário. Esses tipos medem diferentes aspectos da queima de energia, incluindo o gasto total, a queima ativa e as taxas metabólicas de repouso (basal).

Entenda as diferenças entre esses tipos de dados para determinar quais métricas são adequadas ao seu aplicativo.

Tipos de dados compatíveis

A API oferece suporte aos seguintes tipos de dados para medir calorias e gasto energético:

Tabela: tipos de dados de calorias da API Google Health

Tipo de dado   dataType   filter parâmetro	Tipo de registro	Operações disponíveis	Escopo	Suporte a webhook	Suporte a zeros verdadeiros
Calorias queimadas em atividade   active-energy-burned   active_energy_burned	Intervalo	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Total de calorias   total-calories   total_calories	Intervalo	rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

As seções a seguir fornecem detalhes técnicos para cada tipo de dado, incluindo exemplos de representação REST e restrições de integração específicas.

Total de calorias

O total de calorias é um tipo de dado derivado somente leitura que rastreia toda a energia gasta por um usuário, incluindo o metabolismo basal e a energia ativa, medida em quilocalorias (kcal). O valor é calculado com base no gasto energético ativo e na taxa metabólica basal do usuário.

As consultas para o tipo de dado total-calories precisam incluir um filtro de intervalo de tempo (como total_calories.interval.start_time ou total_calories.interval.civil_start_time). O intervalo máximo para essas consultas é de 14 dias.

Exemplo de consulta

Para consultar o tipo de dado total-calories, envie uma solicitação para o endpoint list com um filtro de intervalo:

Solicitação

GET https://health.googleapis.com/v4/users/me/dataTypes/total-calories/dataPoints?filter=total_calories.interval.start_time >= "2026-04-20T00:00:00Z" AND total_calories.interval.start_time < "2026-04-21T00:00:00Z"
Authorization: Bearer access-token
Accept: application/json

Calorias queimadas em atividade

As calorias queimadas em atividade representam a energia queimada pelo usuário durante períodos de atividade, excluindo o gasto energético basal, medido em quilocalorias (kcal).

Exemplo de representação REST

{
  "startTime": "2026-04-20T08:00:00Z",
  "startUtcOffset": "0s",
  "endTime": "2026-04-20T08:30:00Z",
  "endUtcOffset": "0s",
  "dataSource": { ... },
  "kcal": 150.0
}

Diretrizes

Ao integrar métricas de calorias e energia no seu app, use estas diretrizes:

• Visão geral diária:para mostrar o gasto calórico diário geral, solicite o rollup diário do tipo de dado total-calories.
• Gasto somente com atividades:para rastrear as calorias queimadas durante um treino específico ou ao longo do dia, excluindo a taxa metabólica de repouso, consulte active-energy-burned.