कस्टम डेटा टाइप

अगर आपके ऐप्लिकेशन को ऐसी जानकारी कैप्चर करनी है जो 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. डेटा टाइप और उनके फ़ॉर्मैट के फ़ील्ड चुनें.

एचटीटीपी वाला तरीका

POST

यूआरएल का अनुरोध करें

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 एचटीटीपी रिस्पॉन्स स्टेटस कोड मिलेगा. रिस्पॉन्स के मुख्य हिस्से में, datasource.dataStreamId प्रॉपर्टी के साथ-साथ डेटा सोर्स का JSON फ़ॉर्मैट शामिल होता है. डेटा जोड़ने के लिए इस आईडी का इस्तेमाल dataSourceId के रूप में करें.

कस्टम डेटा टाइप का इस्तेमाल करना

Android

ConfigClient.readDataType तरीके का इस्तेमाल करके, अपने कस्टम डेटा टाइप के नाम को स्ट्रिंग से (com.packagename.appname.custom_data_type) को DataType ऑब्जेक्ट में बदलें. कस्टम डेटा डालने और पढ़ने के लिए, लौटाए गए ऑब्जेक्ट का इस्तेमाल करें.

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 API को GET अनुरोध भेजें.

कस्टम डेटा जोड़ना

कस्टम डेटा डालने के लिए, नए डेटा पॉइंट वाला डेटासेट बनाएं. अपने कस्टम डेटा टाइप के लिए, बनाया गया डेटा सोर्स तय करें. डेटा पॉइंट में वे सभी सही फ़ील्ड और फ़ॉर्मैट होने चाहिए जो आपके कस्टम डेटा टाइप में दिए गए हों.

कस्टम डेटा पढ़ना

कस्टम डेटा पढ़ने के लिए, वह डेटा सोर्स बताएं जिसे आपने Google Fit प्लैटफ़ॉर्म से डेटा पॉइंट हासिल करते समय अपने कस्टम डेटा टाइप के लिए बनाया था.