داده های هیدراتاسیون را اضافه کنید

شما می‌توانید با ایجاد یک منبع داده و استفاده از نوع داده com.google.hydration ، داده‌های هیدراتاسیون را به Google Fit اضافه کنید. هر نقطه داده، حجم مصرف شده توسط کاربر را بر حسب لیتر، به عنوان بخشی از یک نوشیدنی واحد نشان می‌دهد. از یک عدد اعشاری برای مشخص کردن حجم استفاده کنید. توجه: مهر زمان نشان می‌دهد که نوشیدنی چه زمانی مصرف شده است. از آنجا که com.google.hydration یک نوع داده لحظه‌ای است، زمان شروع و پایان باید یکسان باشد.

ایجاد منبع داده

اندروید

DataSource.Builder برای ایجاد یک منبع داده جدید استفاده کنید. برای مثال، hydrationSource .

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

استراحت

برای ایجاد یک منبع داده جدید، REST API را فراخوانی کنید. برای مثال، HydrationSource .

روش HTTP

POST

درخواست آدرس اینترنتی

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

افزودن داده‌های هیدراتاسیون

اندروید

این مثال به شما نشان می‌دهد که چگونه یک نقطه داده جدید ایجاد کنید و با استفاده از منبع داده خود، داده‌های مربوط به میزان آب مورد نیاز برای نوشیدن ۰.۳ لیتر آب را به آن اضافه کنید.

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

استراحت

این مثال به شما نشان می‌دهد که چگونه با استفاده از منبع داده خود، داده‌های مربوط به هیدراتاسیون را اضافه کنید.

روش HTTP

PATCH

درخواست آدرس اینترنتی

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