ประเภทข้อมูลแคลอรีและพลังงาน

Google Health API มีประเภทข้อมูลที่ติดตามแคลอรีและการใช้พลังงานของผู้ใช้ โดยประเภทข้อมูลเหล่านี้จะวัดการเผาผลาญพลังงานในแง่มุมต่างๆ รวมถึงการใช้พลังงานทั้งหมด การเผาผลาญพลังงานขณะเคลื่อนไหวร่างกาย และอัตราการเผาผลาญขณะพัก (BMR)

ทำความเข้าใจความแตกต่างระหว่างประเภทข้อมูลเหล่านี้เพื่อกำหนดเมตริกที่เหมาะกับแอปพลิเคชันของคุณ

ประเภทข้อมูลที่รองรับ

API รองรับประเภทข้อมูลต่อไปนี้สำหรับการวัดแคลอรีและการใช้พลังงาน

ตาราง: ประเภทข้อมูลแคลอรีของ Google Health API

Data type   dataType   filter parameter	Record type	Available operations	Scope	Webhook support	True zeros support
พลังงานที่ใช้ไปขณะเคลื่อนไหวร่างกาย   active-energy-burned   active_energy_burned	ช่วงการฝึก	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
แคลอรีทั้งหมด   total-calories   total_calories	ช่วงการฝึก	rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

ส่วนต่อไปนี้จะให้รายละเอียดทางเทคนิคสำหรับข้อมูลแต่ละประเภท รวมถึงตัวอย่างการแสดง REST และข้อจำกัดในการผสานรวมที่เฉพาะเจาะจง

แคลอรีทั้งหมด

แคลอรีทั้งหมดเป็นประเภทข้อมูลที่ได้มาแบบอ่านอย่างเดียว ซึ่งจะติดตามพลังงานทั้งหมดที่ผู้ใช้ใช้ไป รวมถึงการเผาผลาญขณะพักและพลังงานที่ใช้ไปขณะเคลื่อนไหวร่างกาย โดยวัดเป็นกิโลแคลอรี (kcal) ระบบจะคำนวณค่าจากพลังงานที่ใช้ไปขณะเคลื่อนไหวร่างกายและอัตราการเผาผลาญขณะพักของผู้ใช้

การค้นหาประเภทข้อมูล total-calories ต้องมีตัวกรองช่วงเวลา (เช่น total_calories.interval.start_time หรือ total_calories.interval.civil_start_time) ช่วงสูงสุดสำหรับการค้นหาเหล่านี้คือ 14 วัน

ตัวอย่างการค้นหา

หากต้องการค้นหาประเภทข้อมูล total-calories ให้ส่งคำขอไปยังปลายทาง list พร้อมตัวกรองช่วงเวลา

ส่งคำขอ

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

พลังงานที่ใช้ไปขณะเคลื่อนไหวร่างกาย

พลังงานที่ใช้ไปขณะเคลื่อนไหวร่างกายแสดงถึงพลังงานที่ผู้ใช้ใช้ไปในช่วงเวลาที่มีกิจกรรมต่างๆ โดยไม่รวมพลังงานที่ใช้ไปขณะพัก ซึ่งวัดเป็นกิโลแคลอรี (kcal)

ตัวอย่างการแสดง REST

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

หลักเกณฑ์

เมื่อผสานรวมเมตริกแคลอรีและพลังงานในแอป ให้ใช้หลักเกณฑ์ต่อไปนี้

• ภาพรวมรายวัน: หากต้องการแสดงการใช้แคลอรีทั้งหมดในแต่ละวัน ให้ขอข้อมูลสรุปรายวันของประเภทข้อมูล total-calories
• การใช้พลังงานจากกิจกรรมเท่านั้น: หากต้องการติดตามแคลอรีที่ใช้ไประหว่างการออกกำลังกายที่เฉพาะเจาะจงหรือตลอดทั้งวันโดยไม่รวมอัตราการเผาผลาญขณะพัก ให้ค้นหา active-energy-burned