Esta página foi traduzida pela API Cloud Translation.

Users.dataSources.datasets

Um conjunto de dados representa um contêiner de projeção para pontos de dados. Elas não carregam nenhuma informação própria. Os conjuntos de dados representam um conjunto de pontos de dados de uma determinada fonte de dados. 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
`dataSourceId`	`string`	O ID do fluxo de dados da fonte de dados que criou os pontos nesse conjunto de dados.
`maxEndTimeNs`	`long`	O maior horário de término de todos os pontos de dados nesta representação possivelmente parcial do conjunto de dados. A hora é em nanossegundos a partir do período. Ele também deve corresponder à segunda parte do identificador do conjunto de dados.
`minStartTimeNs`	`long`	O menor horário de início de todos os pontos de dados nesta representação possivelmente parcial do conjunto de dados. A hora é em nanossegundos a partir do período. Ele também deve 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 deste conjunto de dados.
`point[]`	`list`	Uma lista parcial de pontos de dados contidos no conjunto de dados, ordenados por endTimeNanos. Essa lista é considerada completa ao recuperar um conjunto de dados pequeno e parcial ao corrigir um conjunto de dados ou recuperar um conjunto de dados grande demais para ser incluído em uma única resposta.
`point[].computationTimeMillis`	`long`	NÃO USE ESTE CAMPO. Ela será ignorada e não será armazenada.
`point[].dataTypeName`	`string`	Tipo de dado 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 a época.
`point[].modifiedTimeMillis`	`long`	Indica a última vez em que esse ponto de dados foi modificado. Útil apenas em contextos em que listamos as mudanças de dados, em vez de representar o estado atual dos dados.
`point[].originDataSourceId`	`string`	Se o ponto de dados estiver em um conjunto de dados para uma fonte de dados derivada, esse campo será preenchido com o ID do fluxo da fonte de dados que criou o ponto de dados originalmente. AVISO: só use esse campo para depuração. Se o campo for definido, o valor dele será um detalhe de implementação e não há garantia de que ele será 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 este ponto de dados, em nanossegundos desde a época.
`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 é listado no tipo de dados especificado em uma fonte de dados. Apenas um dos campos de número inteiro e de ponto flutuante será preenchido, dependendo do valor do formato da enumeração dentro do campo de tipo de fonte de dados.
`point[].value[].fpVal`	`double`	Ponto flutuante. Quando isso for definido, outros valores não poderão ser definidos.
`point[].value[].intVal`	`integer`	Número inteiro. Quando isso for definido, outros valores não poderão ser definidos.
`point[].value[].mapVal[]`	`list`	Valor do mapa. O espaço da chave e as unidades válidos para o valor correspondente de cada entrada deve ser documentado como parte da definição do tipo de dados. Manter as chaves pequenas sempre que possível. Fluxos de dados com chaves grandes e alta frequência de dados podem ser amostrados.
`point[].value[].mapVal[].key`	`string`
`point[].value[].mapVal[].value`	`nested object`
`point[].value[].mapVal[].value.fpVal`	`double`	Ponto flutuante.
`point[].value[].stringVal`	`string`	Valor da string. Quando isso for definido, outros valores não poderão ser definidos. Strings devem ser pequenas sempre que possível. Fluxos de dados com grandes valores de string e alta frequência de dados podem sofrer amostragem.

Métodos

delete: Faz uma exclusão inclusiva de todos os pontos de dados com horários de início e término sobrepostos pelo período especificado pelo ID do conjunto de dados. Para a maioria dos tipos de dados, o ponto de dados inteiro 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 qualquer ponto final do conjunto de dados, apenas a parte sobreposta do ponto de dados é excluída.
get: Retornar um conjunto de dados contendo todos os pontos de dados cujos horários de início e término se sobrepõem ao intervalo especificado dos tempos mínimo e máximo de início do conjunto de dados. Especificamente, qualquer ponto de dados cujo horário de início seja menor ou igual ao horário de término do conjunto de dados e que tenha um horário de término maior 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 ser criado anteriormente. Todos os pontos do conjunto de dados específico 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 patches: os pontos de dados fornecidos são meramente inseridos, sem dados existentes substituídos.