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

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

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

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

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

الجدول: أنواع بيانات السعرات الحرارية في Google Health API
نوع البيانات
  dataType
  filter parameter		 نوع السجلّ
 العمليات
المتاحة		 النطاق إمكانية استخدام إشعارات الويب
 إمكانية استخدام الأصفار الحقيقية
السعرات الحرارية المحروقة أثناء النشاط البدني
  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.
السابق
فهرس أنواع البيانات
التالي
التمارين