Users.dataSources: update

지정된 데이터 소스를 업데이트합니다. version를 제외한 dataStreamId, dataType, type, dataStreamName, device 속성은 수정할 수 없습니다.

데이터 소스는 dataStreamId로 식별됩니다. 사용해 보기

요청

HTTP 요청

PUT https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId

매개변수

매개변수 이름 값 설명
경로 매개변수
dataSourceId string 업데이트할 데이터 소스의 데이터 스트림 ID입니다.
userId string 식별된 사용자의 데이터 소스를 업데이트합니다. me를 사용하여 인증된 사용자를 나타냅니다. 현재 me만 지원됩니다.

승인

이 요청에는 다음 범위 중 하나 이상을 포함하는 승인이 필요합니다.

범위
https://www.googleapis.com/auth/fitness.activity.write
https://www.googleapis.com/auth/fitness.location.write
https://www.googleapis.com/auth/fitness.body.write
https://www.googleapis.com/auth/fitness.nutrition.write
https://www.googleapis.com/auth/fitness.blood_pressure.write
https://www.googleapis.com/auth/fitness.blood_glucose.write
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
https://www.googleapis.com/auth/fitness.body_temperature.write
https://www.googleapis.com/auth/fitness.reproductive_health.write

자세한 내용은 인증 및 승인 페이지를 참고하세요.

요청 본문

요청 본문에서는 다음과 같은 속성을 사용하여 Users.dataSources 리소스를 제공합니다.

속성 이름 값 설명 참고
필수 속성
application nested object 센서 데이터를 플랫폼에 제공하는 애플리케이션에 대한 정보입니다.
application.name string 이 애플리케이션의 이름입니다. REST 클라이언트의 경우 필수 항목이지만 이 이름에는 고유성이 없습니다. 이 ID는 어떤 REST가 애플리케이션이나 데이터 소스를 생성했는지 식별하려는 다른 개발자에게 편의를 위한 목적으로 제공됩니다.
dataStreamId string 이 데이터 소스에서 생성된 데이터 스트림의 고유 식별자입니다. 식별자에는 다음이 포함됩니다.

  • 실제 기기의 제조업체, 모델 및 일련번호 (UID)
  • 애플리케이션의 패키지 이름 또는 이름입니다. 패키지 이름은 Android 애플리케이션에서 데이터 소스를 만들 때 사용됩니다. 개발자 프로젝트 번호는 REST 클라이언트에서 데이터 소스를 만들 때 사용됩니다.
  • 데이터 소스의 유형입니다.
  • 데이터 소스의 스트림 이름입니다.
데이터 소스의 모든 속성이 스트림 식별자의 일부로 사용되는 것은 아닙니다. 특히 하드웨어/애플리케이션 버전은 사용되지 않습니다. 이렇게 하면 버전 업데이트를 통해 동일한 스트림을 유지할 수 있습니다. 즉, 2개의 DataSource 객체가 같지 않더라도 동일한 데이터 스트림을 나타낼 수 있습니다.

Android 애플리케이션에서 만든 데이터 스트림 ID의 정확한 형식은 다음과 같습니다. type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName

REST 클라이언트에서 만드는 데이터 스트림 ID의 정확한 형식은 다음과 같습니다. type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName

데이터 스트림 ID를 구성하는 선택 필드가 있으면 데이터 스트림 ID에서 생략됩니다. 사용 가능한 최소 데이터 스트림 ID는 다음과 같습니다. type:dataType.name:developer 프로젝트 번호

마지막으로 데이터 소스를 만들지 않은 REST 또는 Android 클라이언트에서 읽을 때 개발자 프로젝트 번호 및 기기 UID는 난독화됩니다. 데이터 소스 생성자만 명확하고 일반적인 형식의 개발자 프로젝트 번호를 볼 수 있습니다. 즉, 클라이언트에는 사용자 인증 정보가 다른 다른 클라이언트와 다른 data_stream_ids 세트가 표시됩니다.

dataType nested object 데이터 유형은 피트니스 API에서 수집하거나 삽입하거나 쿼리하는 데이터 스트림의 스키마를 정의합니다.
dataType.field[] list 필드는 데이터 유형의 측정기준을 나타냅니다.
dataType.field[].format string 데이터 유형의 각 필드에 지원되는 다양한 형식

허용되는 값은 다음과 같습니다.
  • "blob"
  • "floatList"
  • "floatPoint"
  • "integer"
  • "integerList"
  • "map"
  • "string"
dataType.field[].name string 데이터의 이름과 형식을 정의합니다. 데이터 유형 이름과 달리 필드 이름은 네임스페이스가 아니며 데이터 유형 내에서 고유해야 합니다.
dataType.name string 각 데이터 유형에는 고유한 네임스페이스화된 이름이 있습니다. com.google 네임스페이스의 모든 데이터 유형은 플랫폼의 일부로 공유됩니다.
device nested object 센서를 보유할 수 있는 통합 기기 (예: 스마트폰 또는 웨어러블 기기)의 표현
device.manufacturer string 제품/하드웨어 제조업체입니다.
device.model string 기기의 최종 사용자에게 표시되는 모델 이름입니다.
device.type string 기기 유형을 나타내는 상수입니다.

허용되는 값은 다음과 같습니다.
  • "chestStrap"
  • "headMounted"
  • "phone"
  • "scale"
  • "smartDisplay"
  • "tablet"
  • "unknown"
  • "watch"
device.uid string 하드웨어의 일련번호 또는 기타 고유 ID입니다. 데이터 소스를 만들지 않은 REST 또는 Android 클라이언트에서 읽을 때 이 필드는 난독화됩니다. 데이터 소스 작성자만 UID 필드가 명확하고 일반적인 형태로 표시됩니다.

난독화는 동등성을 유지합니다. 즉, 두 개의 ID가 주어지면 id1 == id2, italicd(id1) == boldd(id2)입니다.

device.version string 기기 하드웨어/소프트웨어의 버전 문자열입니다.
type string 이 데이터 소스의 유형을 설명하는 상수입니다. 이 데이터 소스가 원시 데이터 또는 파생된 데이터를 생성하는지 여부를 나타냅니다.

허용되는 값은 다음과 같습니다.
  • "derived"
  • "raw"

응답

요청에 성공할 경우 이 메서드는 응답 본문에 Users.dataSources 리소스를 반환합니다.

사용해 보기

아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.