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

يمكنك إضافة بيانات الترطيب إلى 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 لإنشاء مصدر بيانات جديد. مثلاً: 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
    }
   ]
  }
 ]
}

الردّ

إذا تم إنشاء نقطة البيانات بنجاح، ستتلقّى رمز حالة استجابة 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