데이터 세트에 데이터 포인트를 추가합니다. 데이터 세트는 이전에 만들 필요가 없습니다.
지정된 데이터 세트 내의 모든 포인트는 이 데이터 세트를 검색하기 위한 후속 호출로 반환됩니다. 데이터 포인트는 둘 이상의 데이터 세트에 속할 수 있습니다.
이 메서드는 패치 시맨틱스를 사용하지 않습니다. 제공된 데이터 포인트는 기존 데이터가 대체되지 않고 단순히 삽입됩니다.
지금 사용해 보세요.
요청
HTTP 요청
PATCH https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
매개변수
| 매개변수 이름 | 값 | 설명 |
|---|---|---|
| 경로 매개변수 | ||
dataSourceId |
string |
데이터 세트를 만든 데이터 소스의 데이터 스트림 ID입니다. |
datasetId |
string |
이 필드는 사용되지 않으므로 생략해도 됩니다. |
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.datasets 리소스의 관련 부분에 다음 속성을 제공합니다.
| 속성 이름 | 값 | 설명 | Notes |
|---|---|---|---|
| 필수 속성 | |||
dataSourceId |
string |
이 데이터 세트에 있는 포인트를 만든 데이터 소스의 데이터 스트림 ID입니다. | |
maxEndTimeNs |
long |
데이터 세트의 부분적 표현에 있는 모든 데이터 포인트의 최대 종료 시간입니다. 시간은 에포크 기준 나노초 단위입니다. 데이터 세트 식별자의 두 번째 부분과도 일치해야 합니다. | |
minStartTimeNs |
long |
데이터 세트의 부분적 표현에 있는 모든 데이터 포인트의 최소 시작 시간입니다. 시간은 에포크 기준 나노초 단위입니다. 데이터 세트 식별자의 첫 번째 부분과도 일치해야 합니다. | |
point[] |
list |
엔드포인트에 포함된 데이터 포인트의 부분 목록으로, endTimeNanos를 기준으로 정렬됩니다. 이 목록은 작은 데이터 세트를 가져올 때는 완전한 것으로 간주되고, 데이터 세트를 패치하거나 너무 커서 단일 응답에 포함할 수 없는 데이터 세트를 가져올 때는 일부만 표시됩니다. | |
point[].dataTypeName |
string |
이 데이터 포인트의 값 형식을 정의하는 데이터 유형입니다. | |
point[].endTimeNanos |
long |
이 데이터 포인트로 표시되는 간격의 종료 시간(에포크 이후 나노초)입니다. | |
point[].startTimeNanos |
long |
이 데이터 포인트로 표시되는 간격의 시작 시간(에포크 이후 나노초)입니다. | |
point[].value[] |
list |
데이터 포인트에 대한 각 데이터 유형 필드 값입니다. 데이터 유형 필드에 해당하는 각 값은 데이터 소스에 지정된 데이터 유형에 필드가 나열되는 순서와 동일한 순서로 발생합니다. 데이터 소스의 유형 필드 내에 있는 형식 enum 값에 따라 정수 및 부동 소수점 필드 중 하나만 채워집니다. |
|
응답
요청에 성공할 경우 이 메서드는 응답 본문에 Users.dataSources.datasets 리소스를 반환합니다.
사용해 보기
아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.