맞춤 데이터 유형

앱에서 아직 다루지 않은 정보를 캡처해야 하는 경우 맞춤 데이터 유형을 만들 수 있습니다.

커스텀 데이터 유형 만들기

커스텀 데이터를 캡처하기 위한 커스텀 데이터 유형을 만들거나 지정합니다. 생성 시 맞춤 데이터 유형의 경우 다음을 확인하세요.

  • 데이터 유형 이름이 기본 데이터를 정확하게 나타냅니다.

  • 데이터 유형 이름의 접두사는 앱의 패키지 이름과 일치합니다.

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

요청 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 응답 상태 코드가 표시됩니다. 응답 본문에는 데이터 소스(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에 요청할 수 있습니다.

맞춤 데이터 추가

맞춤 데이터를 삽입하려면 새 데이터 포인트가 포함된 데이터 세트를 만듭니다. 맞춤 데이터 유형에 대해 만든 데이터 소스를 지정합니다. 데이터 포인트에는 맞춤 데이터 유형에 지정된 올바른 필드와 형식이 모두 있어야 합니다.

커스텀 데이터 읽기

맞춤 데이터를 읽으려면 맞춤용으로 만든 데이터 소스를 지정하세요. 데이터 유형을 지정해야 합니다.