הוספת נתונים על מאזן הנוזלים

אם רוצים להוסיף נתונים על מאזן הנוזלים אל 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