Users.dataSources: update

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

데이터 소스는 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 클라이언트에 필요하지만 이 이름의 고유성은 강제 적용되지 않습니다. 이는 애플리케이션 또는 데이터 소스를 만든 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 프로젝트 번호
입니다.
마지막으로, 데이터 소스를 생성하지 않은 REST 또는 Android 클라이언트에서 개발자 프로젝트 번호와 기기 UID를 읽을 때 난독화됩니다. 데이터 소스 생성자만 개발자 프로젝트 번호를 명확하고 정상적인 형태로 볼 수 있습니다. 즉, 클라이언트에서는 사용자 인증 정보가 다른 클라이언트와 다른 data_stream_ids 집합을 보게 됩니다.

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

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "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 기기의 유형을 나타내는 상수입니다.

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "chestStrap"
  • "headMounted"
  • "phone"
  • "scale"
  • "smartDisplay"
  • "tablet"
  • "unknown"
  • "watch"
device.uid string 하드웨어의 일련번호 또는 기타 고유 ID입니다. 이 필드는 데이터 소스를 만들지 않은 REST 또는 Android 클라이언트에서 읽을 때 난독화됩니다. 데이터 소스 생성자만 명확하고 정상적인 형식으로 UID 필드를 볼 수 있습니다.

난독화는 동등성을 유지합니다. 즉, 두 개의 ID가 제공된 경우 id1 == id2, obfuscated(id1) == obfuscated(id2)입니다.

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

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "derived"
  • "raw"

응답

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

사용해 보기

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