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

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. أدخِل اسمًا فريدًا لنوع البيانات يمثّل البيانات التي يتم تسجيلها عن كثب.

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
     }
    ]
   }
}

الاستجابة

إذا تم إنشاء مصدر البيانات بنجاح، ستتلقّى رمز حالة استجابة 200 OK HTTP . يحتوي نص الاستجابة على تمثيل بتنسيق 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}")
    }

REST

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

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

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

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

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