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

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

1. يمكنك استدعاء واجهة برمجة تطبيقات REST لإنشاء مصدر بيانات جديد. مثلاً: 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.

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

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

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

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