أنواع البيانات المخصّصة

إذا كان تطبيقك بحاجة إلى التقاط معلومات لم يتم تغطيتها في أحد أنواع البيانات الحالية على نظام 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 API. لالتقاط بيانات مخصّصة، عليك إنشاء مصدر بيانات ثم تحديد نوع البيانات:

1. يمكنك طلب بيانات من REST API لإنشاء مصدر بيانات جديد. مثلاً: FlexibilityMeasure

2. أدخِل اسمًا فريدًا لنوع البيانات، وهو يمثّل بدقة البيانات التي يلتقطها.

   ملاحظة: يمكن أن يكون هذا الاسم مختلفًا، طالما أنه فريد وليس لديه اسم نوع آخر من البيانات. ننصح باستخدام هذه الاتفاقية: com.packagename.appname.custom_data_type

3. حدِّد حقول نوع البيانات وتنسيقاتها.

طريقة 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 API.

إضافة بيانات مخصصة

لإدراج بيانات مخصّصة، عليك إنشاء مجموعة بيانات تتضمّن نقاط بيانات جديدة. حدِّد مصدر البيانات الذي أنشأته لنوع بياناتك المخصّصة. يجب أن تحتوي نقاط البيانات على جميع الحقول والتنسيقات الصحيحة المحدّدة في نوع البيانات المخصّصة.

قراءة البيانات المخصصة

لقراءة البيانات المخصّصة، حدِّد مصدر البيانات الذي أنشأته لنوع بياناتك المخصّصة عند استرداد نقاط البيانات من منصّة Google Fit.