قراءة أصناف الطعام التي تم تناولها

Android

يمكن لتطبيقك الحصول على قائمة بأنواع الطعام التي تم تناولها خلال إطار زمني محدّد من خلال إنشاء طلب قراءة بيانات والاستعلام عن DataType.TYPE_NUTRITION، كما هو موضّح في المثال التالي:

val readRequest = DataReadRequest.Builder()
    .read(DataType.TYPE_NUTRITION)
    .setTimeRange(startTime, endTime, TimeUnit.MILLISECONDS)
    .build()

لمزيد من المعلومات عن قراءة البيانات، يُرجى الاطّلاع على مقالة استخدام سجلّ النشاط في تطبيق "اللياقة البدنية من Google".

راحة

إنّ استرداد قائمة بأنواع الطعام التي تم تناولها من خلال REST API هي عملية تتألف من ثلاث مراحل:

  1. استرداد قائمة بمصادر البيانات المتاحة لنوع البيانات com.google.nutrition بدلاً من ذلك، إذا كانت تفاصيل مصدر البيانات معروفة مسبقًا، يمكن استخدامها مباشرةً في الخطوة التالية.
  2. الحصول على قائمة بأنواع الطعام التي تم تناولها من كل مصدر بيانات بدوره
  3. (في حال توفّر أكثر من مصدر بيانات واحد) دمج قوائم أنواع الطعام ضمن تطبيق العميل

استرداد قائمة بمصادر بيانات الطعام

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

طريقة HTTP

GET

عنوان URL للطلب

https://www.googleapis.com/fitness/v1/users/me/dataSources?dataTypeName=com.google.nutrition&fields=dataSource(dataStreamId)

الردّ

إذا كانت الاستجابة ناجحة، يكون رمز الحالة 200 OK. يحتوي نص الاستجابة على قائمة JSON، ويتوافق كل عنصر في القائمة مع مصدر بيانات.

على سبيل المثال:

{
 "dataSource": [
  {
   "dataStreamId": "raw:com.google.nutrition:com.example.nutritionSource1:"
  },
  {
   "dataStreamId": "raw:com.google.nutrition:com.example.nutritionSource2:"
  }
 ]
}

أمر cURL

$ curl \
  'https://www.googleapis.com/fitness/v1/users/me/dataSources?dataTypeName=com.google.nutrition&fields=dataSource(dataStreamId)' \
      --header 'Authorization: Bearer ya29.yourtokenvalue' \
      --header 'Accept: application/json' \
      --compressed

الحصول على قائمة بأنواع الطعام التي تم تناولها من مصدر بيانات

استخدِم dataSource.dataStreamId من كل مصدر من المصادر في الخطوة 1 بدوره لاسترداد قوائم أنواع الطعام التي تم تناولها.

datasetId هو بداية الفترة الزمنية المطلوبة ونهايتها، بالنانو ثانية كما هو محدّد في مورد مجموعة البيانات.

على سبيل المثال، يمثّل 1546300800000000000-1546387200000000000 السمة datasetId للفترة من 01 يناير 2019 00:00:00 بالتوقيت العالمي المنسّق إلى 02 يناير 2019 00:00:00.

طريقة HTTP

GET

عنوان URL للطلب

https://www.googleapis.com/fitness/v1/users/me/dataSources/dataSource.dataStreamId/datasets/1546300800000000000-1546387200000000000?fields=point%2Fvalue%2FstringVal

الردّ

{
 "point": [
  {
   "value": [
    {},
    {},
    {
     "stringVal": "apple"
    }
   ]
  },
  {
   "value": [
    {},
    {},
    {
     "stringVal": "banana"
    }
   ]
  },
  {
   "value": [
    {},
    {},
    {
     "stringVal": "carrot"
    }
   ]
  }
 ]
}

أمر cURL

$ curl \
  'https://www.googleapis.com/fitness/v1/users/me/dataSources/dataSource.dataStreamId/datasets/157059699023000000-1575159699023999000?fields=point%2Fvalue%2FstringVal' \
      --header 'Authorization: Bearer ya29.yourtokenvalue' \
      --header 'Accept: application/json' \
      --compressed