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

ويمكنك إضافة بيانات استهلاك السوائل إلى 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