إضافة بيانات الترطيب

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

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

Android

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

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

REST

استخدِم واجهة REST API لإنشاء مصدر بيانات جديد. على سبيل المثال، 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()

REST

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

طريقة 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
    }
   ]
  }
 ]
}

الردّ

إذا تم إنشاء نقطة البيانات بنجاح، ستتلقّى رمز حالة استجابة 200 OK HTTP. يحتوي نص الاستجابة على تمثيل 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