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 esse valor é definido, não é 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 no 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.