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 리소스를 제공합니다.

속성 이름 값 설명 Notes
필수 속성
application nested object 센서 데이터를 플랫폼에 제공하는 애플리케이션에 관한 정보입니다.
application.name string 이 애플리케이션의 이름입니다. REST 클라이언트의 경우 필수이지만 이 이름의 고유성은 적용되지 않습니다. 이 정보는 애플리케이션 또는 데이터 소스를 만든 REST를 확인하려는 다른 개발자를 위해 편의를 위해 제공됩니다.
dataStreamId string 이 데이터 소스에서 생성된 데이터 스트림의 고유 식별자입니다. 식별자에는 다음이 포함됩니다.

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

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

dataType nested object 데이터 유형은 Fitness 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 필드를 볼 수 있습니다.

난독화는 동등성을 유지합니다. 즉, id1 == id2, obfuscated(id1) == obfuscated(id2) ID가 2개 있습니다.

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

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

응답

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

사용해 보기

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