إذا كان تطبيقك يحتاج إلى تسجيل معلومات لا يغطيها أحد أنواع البيانات الحالية على نظام Google Fit الأساسي، يمكنك إنشاء نوع بيانات مخصّص.
إنشاء أنواع بيانات مخصصة
إنشاء أو تحديد نوع بيانات مخصصة لتسجيل البيانات المخصصة. عند إنشاء أنواع بيانات مخصّصة، تأكّد ممّا يلي:
- يمثل اسم نوع البيانات البيانات الأساسية بدقة.
وتتطابق بادئة اسم نوع البيانات مع اسم حزمة تطبيقك.
Android
لإنشاء نوع بيانات مخصّص للمرة الأولى، استخدِم الإجراء
ConfigClient.createCustomDataType
التالي:
val request = DataTypeCreateRequest.Builder()
// The prefix of your data type name must match your app's package name
.setName("com.packagename.appname.custom_data_type") // Add some custom fields, both int and float
.addField("field1", Field.FORMAT_INT32)
.addField("field2", Field.FORMAT_FLOAT)
// Add some common fields
.addField(Field.FIELD_ACTIVITY)
.build()
Fitness.getConfigClient(this, account)
.createCustomDataType(request)
.addOnSuccessListener { dataType ->
// Use this custom data type to insert data into your app.
Log.d(TAG, "Created data type: ${dataType.name}")
}
راحة
أنواع البيانات هي سمة لمصادر البيانات في واجهة برمجة التطبيقات REST. للحصول على بيانات مخصصة، تحتاج إلى إنشاء مصدر بيانات ثم تحديد نوع البيانات:
- يمكنك استدعاء واجهة برمجة تطبيقات REST لإنشاء مصدر بيانات جديد. مثلاً:
FlexibilityMeasure
امنح نوع البيانات اسمًا فريدًا يمثل بدقة البيانات التي يجمعها.
.حدِّد حقول نوع البيانات وتنسيقاتها.
طريقة HTTP
POST
طلب عنوان URL
https://www.googleapis.com/fitness/v1/users/me/dataSources
نص الطلب
{
"dataStreamName": "FlexibilityMeasure",
"type": "raw",
"application": {
"detailsUrl": "http://recoveryapps.com",
"name": "Stretch Flex",
"version": "1"
},
"dataType": {
"name": "com.recoveryapps.stretchflex.flexibility",
"field": [
{
"name": "ankle_range_degrees",
"format": "integer"
},
{
"name": "wrist_range_degrees",
"format": "integer",
"optional": true
}
]
}
}
الرد
إذا تم إنشاء مصدر البيانات بنجاح، ستحصل على رمز حالة استجابة HTTP 200 OK
. يحتوي نص الاستجابة على تمثيل JSON لمصدر البيانات، بما في ذلك السمة datasource.dataStreamId
. استخدِم هذا المعرّف
على أنّه dataSourceId
لإضافة البيانات.
استخدام أنواع البيانات المخصصة
Android
حوِّل اسم نوع البيانات المخصّصة من سلسلة
(com.packagename.appname.custom_data_type) إلى كائن DataType
باستخدام الإجراء
ConfigClient.readDataType
. استخدِم الكائن الذي تم عرضه لإدراج
البيانات المخصّصة وقراءتها.
Fitness.getConfigClient(this, account)
.readDataType("com.packagename.appname.custom_data_type")
.addOnSuccessListener { dataType ->
// Use this custom data type to insert data into your app.
Log.d(TAG, "Retrieved data type: ${dataType.name}")
}
راحة
لإضافة بيانات مخصّصة أو قراءتها باستخدام أنواع بياناتك المخصّصة، تحتاج إلى مصادر البيانات المتعلّقة بها. للتحقق من مصادر البيانات لنوع مخصّص من البيانات، يمكنك إرسال طلب GET
إلى واجهة برمجة تطبيقات REST.
إضافة بيانات مخصصة
لإدراج بيانات مخصصة، أنشئ مجموعة بيانات بنقاط بيانات جديدة. حدد مصدر البيانات الذي أنشأته لنوع البيانات المخصصة لديك. يجب أن تحتوي نقاط البيانات على جميع الحقول والتنسيقات الصحيحة المحددة في نوع البيانات المخصّص.
قراءة البيانات المخصَّصة
لقراءة البيانات المخصَّصة، حدِّد مصدر البيانات الذي أنشأته لنوع البيانات المخصَّصة عند استرداد نقاط البيانات من منصّة Google Fit.