Tipos de dados de calorias e energia

A API Google Health oferece tipos de dados que rastreiam as calorias e o gasto de energia de um usuário. Esses tipos medem diferentes aspectos do gasto de energia, incluindo o total, o gasto ativo e as taxas metabólicas em 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 é compatível com os seguintes tipos de dados para medir calorias e gasto de energia:

Tabela: tipos de dados de calorias da API Google Health

Tipo de dado   dataType Parâmetro   filter	Record type	Operações disponíveis	Escopo	Suporte a webhook	Suporte a zeros reais
Gasto de energia ativa   active-energy-burned   active_energy_burned	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Energia basal queimada   basal-energy-burned   basal_energy_burned	Intervalo	list, reconcile	activity_and_fitness
Taxa metabólica basal   basal-metabolic-rate   basal_metabolic_rate	Exemplo	list, reconcile	nutrição

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

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

Calorias queimadas em atividade

As calorias queimadas em atividade representam a energia gasta 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
}

Energia basal queimada

A energia basal queimada representa as calorias queimadas devido ao metabolismo em repouso do usuário em intervalos de tempo, medidas em quilocalorias (kcal).

Observação:as operações de rollup e rollup diário não estão disponíveis para esse tipo de dados. Para receber valores diários de energia basal, use o tipo de dados "Taxa metabólica basal".

Taxa metabólica basal

A taxa metabólica basal mede a energia gasta por um corpo em um estado normal de repouso, medida em quilocalorias por dia (kcal/day). Como essa taxa varia com atualizações físicas (como peso) ao longo do tempo, a API registra a TMB como uma série temporal de amostras de taxa.

Os desenvolvedores podem tratar o campo rateKcalPerDay em uma amostra basal-metabolic-rate como a contraparte diária de uma consolidação diária de calorias gastas.

Exemplo de representação REST

{
  "date": {
    "year": 2026,
    "month": 4,
    "day": 20
  },
  "dataSource": { ... },
  "rateKcalPerDay": 1650.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 resumo diário do tipo de dados total-calories.
• Gasto apenas com atividade:para acompanhar as calorias queimadas durante um treino específico ou ao longo do dia, sem incluir a taxa metabólica em repouso, consulte active-energy-burned.
• Métricas basais:para acompanhar a taxa metabólica em repouso ou as tendências metabólicas basais, consulte basal-metabolic-rate para valores de TMB. Trate as amostras de TMB como um valor de referência diário para o consumo de energia em repouso do usuário.