เพิ่มข้อมูลปริมาณน้ำที่ดื่ม

คุณสามารถเพิ่มข้อมูลปริมาณน้ำที่ดื่มลงใน Google Fit ได้โดยการสร้างแหล่งข้อมูลและใช้ ประเภทข้อมูล com.google.hydration จุดข้อมูลแต่ละจุดแสดงถึงปริมาตรเป็นลิตรที่ผู้ใช้ดื่มในแต่ละครั้ง ใช้ค่า Float เพื่อระบุปริมาตร หมายเหตุ: การประทับเวลาจะระบุเวลาที่ดื่ม เนื่องจาก 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
    }
   ]
  }
 ]
}

การตอบกลับ

หากสร้างจุดข้อมูลเรียบร้อยแล้ว คุณจะได้รับรหัสสถานะการตอบกลับ HTTP200 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