إضافة بيانات شرب السوائل

يمكنك إضافة بيانات شرب السوائل في Google Fit من خلال إنشاء مصدر بيانات واستخدام نوع البيانات com.google.hydration. تمثّل كل نقطة بيانات الحجم باللتر الذي يستهلكه المستخدم كجزء من مشروب واحد. يمكنك استخدام لوحة عائمة لتحديد مستوى الصوت. ملاحظة: يشير الطابع الزمني إلى وقت استهلاك الشراب. بما أنّ com.google.hydration هو نوع بيانات فوري، يجب أن يتطابق وقت البدء معًا.

إنشاء مصدر بيانات

Android

استخدِم DataSource.Builder لإنشاء مصدر بيانات جديد. مثلاً: hydrationSource

val hydrationSource = DataSource.Builder()
    .setDataType(DataType.TYPE_HYDRATION)
    .setStreamName("hydrationSource")
    // ... 
    .build()

راحة

يمكنك الاتصال بواجهة برمجة تطبيقات REST لإنشاء مصدر بيانات جديد. مثلاً: HydrationSource

طريقة HTTP

POST

عنوان URL للطلب

https://www.googleapis.com/fitness/v1/users/me/dataSources

نص الطلب

{
  "dataStreamName": "HydrationSource",
  "type": "raw",
  "application": {
    "detailsUrl": "http://example.com",
    "name": "My Example App",
    "version": "1"
  },
  "dataType": {
    "name": "com.google.hydration",
    "field": [
     {
      "name": "volume",
      "format": "floatPoint",
      "optional": false
     }
    ]
   }
}

الردّ

إذا تم إنشاء مصدر البيانات بنجاح، تكون الاستجابة هي حالة الحالة 200 OK. يحتوي نص الاستجابة على تمثيل JSON لمصدر البيانات، بما في ذلك سمة datasource.dataStreamId التي يمكنك استخدامها كرقم تعريف مصدر البيانات للطلبات اللاحقة.

أمر CURL

$ curl --header "Authorization: Bearer ya29.yourtokenvalue" --request POST \
  --header "Content-Type: application/json;encoding=utf-8" --data @hydration-ds.json \
  https://www.googleapis.com/fitness/v1/users/me/dataSources

إضافة بيانات شرب السوائل

Android

يوضح هذا المثال كيفية إنشاء نقطة بيانات جديدة، وإضافة بيانات شرب السوائل لمشروب مياه بحجم 0.3 لتر، باستخدام مصدر البيانات.

val hydration = DataPoint.builder(hydrationSource)
    .setTimestamp(timestamp, TimeUnit.MILLISECONDS)
    .setField(FIELD_VOLUME, 0.3f)
    .build()

راحة

يعرض لك هذا المثال طريقة إضافة بيانات شرب السوائل باستخدام مصدر البيانات.

طريقة HTTP

PATCH

عنوان URL للطلب

https://www.googleapis.com/fitness/v1/users/me/dataSources/raw:com.google.hydration:407408718192:HydrationSource/datasets/1275753581000000000-1275753581000000000

نص الطلب

{
 "minStartTimeNs": 1275753581000000000,
 "maxEndTimeNs": 1275753581000000000,
 "dataSourceId": "raw:com.google.hydration:407408718192:HydrationSource",
 "point": [
  {
   "startTimeNanos": 1275753581000000000,
   "endTimeNanos": 1275753581000000000,
   "dataTypeName": "com.google.hydration",
   "value": [
    {
     "fpVal": 0.3
    }
   ]
  }
 ]
}

الردّ

إذا تم إنشاء نقطة البيانات بنجاح، ستتلقّى رمز حالة استجابة HTTP 200 OK. يحتوي نص الاستجابة على تمثيل JSON لمجموعة البيانات.

أمر CURL

$ curl --header "Authorization: Bearer ya29.yourtokenvalue" --request PATCH \
  --header "Content-Type: application/json;encoding=utf-8" --data @hydration-data.json \
  https://www.googleapis.com/fitness/v1/users/me/dataSources/raw:com.google.hydration:407408718192:HydrationSource/datasets/1275753581000000000-1275753581000000000