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