Özel veri türleri

Uygulamanızın, Google Fit platformundaki mevcut veri türlerinden birinde yer almayan bilgileri yakalaması gerekiyorsa özel bir veri türü oluşturabilirsiniz.

Özel veri türleri oluşturma

Özel verileri yakalamak için özel bir veri türü oluşturun veya belirtin. Özel veri türleri oluşturduğunuzda şunlara dikkat edin:

  • Veri türü adı, temel veriyi doğru şekilde temsil etmektedir.

  • Veri türü adının öneki, uygulamanızın paket adıyla eşleşir.

Android

İlk kez özel veri türü oluşturmak için ConfigClient.createCustomDataType yöntemini kullanın:

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

Veri türleri, REST API'deki veri kaynaklarının bir özelliğidir. Özel verileri yakalamak için bir veri kaynağı oluşturmanız ve ardından veri türünü belirtmeniz gerekir:

  1. Yeni veri kaynağı oluşturmak için REST API'yi çağırın. Örneğin, FlexibilityMeasure.

  2. Veri türüne, yakaladığı verileri yakından temsil eden benzersiz bir ad verin.

  3. Veri türü alanlarını ve biçimlerini belirtin.

HTTP yöntemi

POST

İstek URL'si

https://www.googleapis.com/fitness/v1/users/me/dataSources

İstek metni

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

Yanıt

Veri kaynağınız başarıyla oluşturulduysa 200 OK HTTP yanıt durum kodu alırsınız. Yanıt gövdesi, datasource.dataStreamId özelliği de dahil olmak üzere veri kaynağının JSON gösterimini içerir. Veri eklemek için bu kimliği dataSourceId olarak kullanın.

Özel veri türlerini kullanma

Android

ConfigClient.readDataType yöntemini kullanarak bir dizedeki (com.packagename.appname.custom_data_type) özel veri türünüzün adını bir DataType nesnesine dönüştürün. Özel verileri eklemek ve okumak için döndürülen nesneyi kullanın.

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

Özel veri türlerinizi kullanarak özel veriler eklemek veya okumak için veri kaynaklarına ihtiyacınız vardır. Özel bir veri türünün veri kaynaklarını kontrol etmek için REST API'ye GET isteği gönderin.

Özel veri ekleme

Özel veri eklemek için yeni veri noktaları içeren bir veri kümesi oluşturun. Özel veri türünüz için oluşturduğunuz veri kaynağını belirtin. Veri noktaları, özel veri türünüzde belirtilen tüm doğru alanlara ve biçimlere sahip olmalıdır.

Özel verileri okuma

Özel verileri okumak istiyorsanız Google Fit platformundan veri noktaları alırken özel veri türünüz için oluşturduğunuz veri kaynağını belirtin.