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 da queima de energia, incluindo gasto total, queima ativa e 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	nutrition

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.

Observação:as consultas para o tipo de dados total-calories precisam incluir um filtro de intervalo de tempo (como total_calories.interval.start_time ou total_calories.interval.civil_start_time). O período máximo para essas consultas é de 14 dias.

Exemplo de consulta

Para consultar o tipo de dados total-calories, envie uma solicitação ao 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 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 visualização completa e de visualização completa diária 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 um resumo diário de energia basal queimada.

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.