自訂資料類型

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

資料類型是 REST API 中資料來源的屬性。如要擷取自訂資料，您必須先建立資料來源，然後指定資料類型：

1. 呼叫 REST API 來建立新的資料來源。例如 FlexibilityMeasure。

2. 為資料類型提供專屬名稱，清楚呈現其所擷取的資料。

3. 指定資料類型和格式欄位。

HTTP 方法

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 HTTP 回應狀態碼。回應主體包含資料來源的 JSON 表示法，包括 datasource.dataStreamId 屬性。使用這個 ID 做為 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

如要使用自訂資料類型新增或讀取自訂資料，您需要其資料來源。如要查看自訂資料類型的資料來源，請將 GET 要求傳送至 REST API。

新增自訂資料

如要插入自訂資料，請使用新資料點建立資料集。指定您為自訂資料類型建立的資料來源。資料點必須具有您在自訂資料類型中指定的所有正確欄位和格式。

讀取自訂資料

如要讀取自訂資料，請指定從 Google Fit 平台擷取資料點時，為自訂資料類型建立的資料來源。