Users.dataSources.datasets

Um conjunto de dados representa um contêiner de projeção para pontos de dados. Eles não carregam nenhuma informação própria. Os conjuntos de dados representam um conjunto de pontos de dados de uma fonte de dados específica. Um ponto de dados pode ser encontrado em mais de um conjunto de dados.

Para ver uma lista de métodos desse recurso, consulte o final desta página.

Representações de recursos

{
  "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
}
Nome da propriedade Valor Descrição Observações
dataSourceId string O ID do fluxo de dados da fonte de dados que criou os pontos neste conjunto de dados.
maxEndTimeNs long O maior horário de término de todos os pontos de dados nessa representação possivelmente parcial do conjunto de dados. O horário é expresso em nanossegundos a partir da época. Ele também precisa corresponder à segunda parte do identificador do conjunto de dados.
minStartTimeNs long O menor horário de início de todos os pontos de dados nessa representação possivelmente parcial do conjunto de dados. O horário é expresso em nanossegundos a partir da época. Ele também precisa corresponder à primeira parte do identificador do conjunto de dados.
nextPageToken string Esse token será definido quando um conjunto de dados for recebido em resposta a uma solicitação GET e o conjunto de dados for muito grande para ser incluído em uma única resposta. Forneça esse valor em uma solicitação GET subsequente para retornar a próxima página de pontos de dados dentro desse conjunto de dados.
point[] list Uma lista parcial de pontos de dados contidos no conjunto de dados, ordenados por endTimeNanos. Essa lista é considerada completa na recuperação de um conjunto de dados pequeno e parcial na correção de um conjunto de dados ou na recuperação de um conjunto de dados muito grande para ser incluído em uma única resposta.
point[].computationTimeMillis long NÃO USE ESTE CAMPO. Ele é ignorado e não é armazenado.
point[].dataTypeName string O tipo de dados que define o formato dos valores neste ponto de dados.
point[].endTimeNanos long O horário de término do intervalo representado por esse ponto de dados, em nanossegundos, desde o período.
point[].modifiedTimeMillis long Indica a última vez que este ponto de dados foi modificado. Útil somente em contextos em que estamos listando as mudanças de dados, em vez de representar o estado atual deles.
point[].originDataSourceId string Se o ponto de dados estiver contido em um conjunto de dados de uma origem derivada, esse campo será preenchido com o ID do fluxo da origem de dados que criou o ponto de dados originalmente.

AVISO: não confie neste campo apenas para depuração. O valor deste campo, se for definido, é um detalhe de implementação e não há garantia de que ele permaneça consistente.
point[].rawTimestampNanos long O carimbo de data/hora bruto do SensorEvent original.
point[].startTimeNanos long O horário de início do intervalo representado por esse ponto de dados, em nanossegundos, desde o período.
point[].value[] list Valores de cada campo de tipo de dados para o ponto de dados. Espera-se que cada valor correspondente a um campo de tipo de dados ocorra na mesma ordem em que o campo está listado no tipo de dados especificado em uma fonte de dados.

Somente um dos campos de número inteiro e de ponto flutuante será preenchido, dependendo do valor do formato enum no campo de tipo da fonte de dados.

point[].value[].fpVal double Valor de ponto flutuante. Quando esse valor é definido, não é possível definir outros valores.
point[].value[].intVal integer Número inteiro. Quando este valor for definido, não será possível definir outros valores.
point[].value[].mapVal[] list Valor do mapa. O espaço-chave válido e as unidades para o valor correspondente de cada entrada devem ser documentados como parte da definição do tipo de dados. As chaves precisam ser pequenas sempre que possível. Os fluxos de dados com chaves grandes e alta frequência de dados podem ser retirados da amostragem.
point[].value[].mapVal[].key string
point[].value[].mapVal[].value nested object
point[].value[].mapVal[].value.fpVal double Valor de ponto flutuante.
point[].value[].stringVal string Valor da string. Quando esse valor é definido, não é possível definir outros valores. Mantenha as strings pequenas sempre que possível. Os fluxos de dados com valores de string grandes e alta frequência de dados podem ser retirados da amostragem.

Métodos

delete
Executa uma exclusão inclusiva de todos os pontos de dados com horários de início e término têm alguma sobreposição com o período especificado pelo ID do conjunto de dados. Para a maioria o ponto de dados será excluído. Para tipos de dados em que o período representa um valor consistente (como com.google.activity.segment), e um ponto de dados abrange ponto final do conjunto de dados, apenas a parte sobreposta dos dados ponto será excluído.
get
Retorna um conjunto de dados que contém todos os pontos de dados com horários de início e término se sobrepõem ao intervalo especificado do horário de início mínimo do conjunto de dados e horário de término máximo. Especificamente, qualquer ponto de dados com horário de início menor que ou igual à hora de término do conjunto de dados e cuja hora de término seja maior que ou igual ao horário de início do conjunto de dados.
patch
Adiciona pontos de dados a um conjunto de dados. O conjunto de dados não precisa ter sido criado anteriormente. Todos os pontos dentro do conjunto de dados determinado serão retornados com chamadas subsequentes para recuperar esse conjunto de dados. Os pontos de dados podem pertencer a mais de um conjunto de dados.

Esse método não usa semântica de patch: os pontos de dados fornecidos são simplesmente inseridos, sem nenhum dado existente substituído.