أنواع بيانات السعرات الحرارية والطاقة

توفّر Google Health API أنواع بيانات تتتبّع السعرات الحرارية التي يتناولها المستخدم ومقدار الطاقة التي يصرفها. تقيس هذه الأنواع جوانب مختلفة من حرق السعرات الحرارية، بما في ذلك إجمالي السعرات الحرارية المحروقة والسعرات الحرارية المحروقة أثناء النشاط ومعدلات الأيض الأساسية (أثناء الراحة).

ننصحك بالتعرّف على الاختلافات بين أنواع البيانات هذه لتحديد المقاييس المناسبة لتطبيقك.

أنواع البيانات المتوافقة

تتيح واجهة برمجة التطبيقات أنواع البيانات التالية لقياس السعرات الحرارية واستهلاك الطاقة:

الجدول: أنواع بيانات السعرات الحرارية في Google Health API

نوع البيانات   dataType   filter المَعلمة	نوع السجلّ	العمليات المتاحة	النطاق	إتاحة استخدام ويب هوك	إتاحة القيم الصفرية
السعرات الحرارية المحروقة   active-energy-burned   active_energy_burned	الفاصل الزمني	list, reconcile, rollup, dailyRollup	activity_and_fitness
إجمالي السعرات الحرارية   total-calories   total_calories	الفاصل الزمني	rollup, dailyRollup	activity_and_fitness

تقدّم الأقسام التالية تفاصيل فنية لكل نوع من أنواع البيانات، بما في ذلك أمثلة على تمثيل 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.