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

إذا كان تطبيقك يحتاج إلى تسجيل معلومات غير مشمولة في إحدى أنواع البيانات الحالية على نظام 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 API.

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

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

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

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