כדי להוסיף נתוני מאזן הנוזלים ל-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
קוראים ל-API ל-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()
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
}
]
}
]
}
תגובה
אם הנקודה על הגרף נוצרה בהצלחה, תקבלו קוד 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