يمكنك إضافة بيانات شرب السوائل في Google Fit من خلال إنشاء مصدر بيانات واستخدام نوع البيانات com.google.hydration
. تمثّل كل نقطة بيانات الحجم باللتر الذي يستهلكه المستخدم كجزء من مشروب واحد. يمكنك استخدام لوحة عائمة
لتحديد مستوى الصوت.
ملاحظة: يشير الطابع الزمني إلى وقت استهلاك الشراب. بما أنّ com.google.hydration
هو نوع بيانات فوري، يجب أن يتطابق وقت البدء معًا.
إنشاء مصدر بيانات
Android
استخدِم DataSource.Builder
لإنشاء مصدر بيانات جديد. مثلاً: hydrationSource
val hydrationSource = DataSource.Builder()
.setDataType(DataType.TYPE_HYDRATION)
.setStreamName("hydrationSource")
// ...
.build()
راحة
يمكنك الاتصال بواجهة برمجة تطبيقات 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()
راحة
يعرض لك هذا المثال طريقة إضافة بيانات شرب السوائل باستخدام مصدر البيانات.
طريقة 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