Users.dataSources.datasets

데이터 세트는 데이터 포인트의 프로젝션 컨테이너를 나타냅니다. 자체적인 정보는 갖고 있지 않습니다. 데이터 세트는 특정 데이터 소스의 데이터 포인트 집합을 나타냅니다. 하나의 데이터 포인트는 둘 이상의 데이터 세트에서 찾을 수 있습니다.

이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.

리소스 표현

{
  "minStartTimeNs": long,
  "maxEndTimeNs": long,
  "dataSourceId": string,
  "point": [
    {
      "startTimeNanos": long,
      "endTimeNanos": long,
      "dataTypeName": string,
      "originDataSourceId": string,
      "value": [
        {
          "intVal": integer,
          "fpVal": double,
          "stringVal": string,
          "mapVal": [
            {
              "key": string,
              "value": {
                "fpVal": double
              }
            }
          ]
        }
      ],
      "modifiedTimeMillis": long,
      "rawTimestampNanos": long,
      "computationTimeMillis": long
    }
  ],
  "nextPageToken": string
}
속성 이름 값 설명 참고
dataSourceId string 이 데이터 세트의 점을 만든 데이터 소스의 데이터 스트림 ID입니다.
maxEndTimeNs long 데이터 세트의 부분적 표현일 수 있는 모든 데이터 포인트의 최대 종료 시간입니다. 시간은 에포크로부터 나노초 단위입니다. 데이터 세트 식별자의 두 번째 부분과도 일치해야 합니다.
minStartTimeNs long 데이터 세트의 부분적 표현에 있는 모든 데이터 포인트의 최소 시작 시간입니다. 시간은 에포크로부터 나노초 단위입니다. 데이터 세트 식별자의 첫 번째 부분과도 일치해야 합니다.
nextPageToken string GET 요청에 대한 응답으로 데이터 세트가 수신된 경우 이 토큰은 데이터 세트가 너무 커서 단일 응답에 포함할 수 없는 경우 설정됩니다. 이후 GET 요청에서 이 값을 제공하여 이 데이터 세트에 있는 데이터 포인트의 다음 페이지를 반환합니다.
point[] list 데이터세트에 포함된 데이터 포인트의 일부 목록으로, endTimeNanos 순으로 정렬됩니다. 이 목록은 작은 데이터세트를 검색하는 경우 완전한 것으로, 데이터세트를 패치하거나 너무 큰 데이터세트를 단일 응답에 포함할 수 없는 경우에는 일부만 가져오는 것으로 간주됩니다.
point[].computationTimeMillis long 이 입력란을 사용하지 마세요. 무시되며 저장되지 않습니다.
point[].dataTypeName string 이 데이터 포인트의 값 형식을 정의하는 데이터 유형입니다.
point[].endTimeNanos long 이 데이터 포인트가 나타내는 간격의 종료 시간(에포크 이후 나노초)입니다.
point[].modifiedTimeMillis long 이 데이터 포인트가 마지막으로 수정된 시간을 나타냅니다. 데이터의 현재 상태를 나타내는 대신 데이터 변경사항을 나열하는 컨텍스트에서만 유용합니다.
point[].originDataSourceId string 데이터 포인트가 파생된 데이터 소스의 데이터 세트에 포함된 경우 이 필드는 데이터 포인트를 처음 만든 데이터 소스 스트림 ID로 채워집니다.

경고: 디버깅 이외의 용도로 이 필드를 사용하지 마세요. 이 필드의 값이 설정된 경우 구현 세부정보이며 일관성이 보장되지 않습니다.
point[].rawTimestampNanos long 원래 SensorEvent의 원시 타임스탬프입니다.
point[].startTimeNanos long 이 데이터 포인트가 나타내는 간격의 시작 시간(에포크 이후 나노초)입니다.
point[].value[] list 데이터 포인트의 각 데이터 유형 필드 값입니다. 데이터 유형 필드에 해당하는 각 값은 필드가 데이터 소스에 지정된 데이터 유형에 나열되는 순서와 동일한 순서로 나타나야 합니다.

데이터 소스의 유형 필드 내 형식 enum 값에 따라 정수 및 부동 소수점 필드 중 하나만 채워집니다.

point[].value[].fpVal double 부동 소수점 값입니다. 이 값이 설정되면 다른 값을 설정하면 안 됩니다.
point[].value[].intVal integer 정수 값. 이 값이 설정되면 다른 값을 설정하면 안 됩니다.
point[].value[].mapVal[] list 맵 값입니다. 각 항목의 해당 값에 대한 유효한 키 공간과 단위는 데이터 유형 정의의 일부로 문서화되어야 합니다. 키는 가능한 한 작게 유지해야 합니다. 키가 크고 데이터 빈도가 높은 데이터 스트림은 다운 샘플링될 수 있습니다.
point[].value[].mapVal[].key string
point[].value[].mapVal[].value nested object
point[].value[].mapVal[].value.fpVal double 부동 소수점 값입니다.
point[].value[].stringVal string 문자열 값입니다. 이 값이 설정되면 다른 값을 설정하면 안 됩니다. 문자열은 가능한 한 작게 유지해야 합니다. 문자열 값이 크고 데이터 빈도가 높은 데이터 스트림은 다운 샘플링될 수 있습니다.

메서드

삭제
시작 시간과 종료 시간이 있는 모든 데이터 포인트를 포괄적으로 삭제합니다. 데이터 세트 ID로 지정된 기간과 겹치는 부분이 있는지 확인합니다. 대부분의 경우 데이터 유형의 경우 전체 데이터 포인트가 삭제됩니다. 기간은 일관된 값을 나타냄 (예: com.google.activity.segment), 데이터 포인트 전체 데이터 세트의 한쪽 끝 지점이나 데이터에서 겹치는 부분만 포인트가 삭제됩니다.
get
시작 시간과 종료 시간이 있는 모든 데이터 포인트를 포함하는 데이터 세트를 반환합니다. 데이터 세트의 지정된 최소 시작 시간 범위와 겹칩니다. 최대 종료 시간입니다. 특히 시작 시간이 이보다 짧은 모든 데이터 포인트는 데이터 세트 종료 시간과 같거나 종료 시간이 다음보다 크거나 같음 데이터 세트 시작 시간과 같아야 합니다.
patch
데이터 세트에 데이터 포인트를 추가합니다. 데이터 세트를 이전에 만들 필요가 없습니다. 지정된 데이터 세트 내의 모든 포인트가 후속 호출과 함께 반환됩니다. 이 데이터 세트를 가져옵니다. 데이터 포인트는 둘 이상의 데이터 세트에 속할 수 있습니다.

이 방법은 패치 시맨틱스를 사용하지 않습니다. 제공된 데이터 포인트는 기존 데이터는 대체되지 않고 단순히 삽입될 뿐입니다.