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