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 | 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 tempo é representado por nanossegundos a partir da época. 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 nessa representação possivelmente parcial do conjunto de dados. O tempo é representado por nanossegundos a partir da época. 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 nesse conjunto. | |
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 quando você aplica patches em um conjunto de dados ou recupera um conjunto de dados grande demais para ser incluído em uma única resposta. | |
point[].computationTimeMillis |
long |
NÃO USE ESTE CAMPO. Ela é ignorada e não é armazenada. | |
point[].dataTypeName |
string |
O tipo de dados que define o formato dos valores nesse ponto de dados. | |
point[].endTimeNanos |
long |
O horário de término do intervalo representado por esse ponto de dados, em nanossegundos, a partir do período. | |
point[].modifiedTimeMillis |
long |
Indica a última vez que esse ponto de dados foi modificado. Útil apenas nos contextos em que estivermos listando as mudanças nos dados, em vez de representar o estado atual deles. | |
point[].originDataSourceId |
string |
Se o ponto de dados estiver contido 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: não dependa desse campo para outra coisa que não seja a depuração. O valor desse campo, se definido, é um detalhe de implementação e não tem garantia de consistência. |
|
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, a partir do 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 ponto flutuante será preenchido, dependendo do valor da enumeração do formato no campo de tipo da fonte de dados. |
|
point[].value[].fpVal |
double |
Valor de ponto flutuante. Quando esse valor é definido, outros valores não podem ser definidos. | |
point[].value[].intVal |
integer |
Número inteiro. Quando esse valor é definido, outros valores não podem ser definidos. | |
point[].value[].mapVal[] |
list |
Valor do mapa. O espaço de chave e as unidades válidos para o valor correspondente de cada entrada precisam 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 podem sofrer amostragem inferior. | |
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, outros valores não podem ser definidos. As strings devem ser mantidas pequenas sempre que possível. Os fluxos de dados com grandes valores de string e alta frequência podem sofrer uma amostragem inferior. |
Métodos
- excluir
- Executa uma exclusão inclusiva de todos os pontos de dados com horários de início e término que se sobrepõem ao intervalo 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 um ponto final do conjunto de dados, somente a parte sobreposta do ponto de dados é excluída. - get
- Retorna um conjunto de dados que contém todos os pontos de dados cujos horários de início e término se sobrepõem ao intervalo especificado do horário mínimo e máximo de início do conjunto de dados. Especificamente, qualquer ponto de dados cujo horário de início é menor ou igual ao horário de término do conjunto de dados e cujo 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 ter sido criado anteriormente.
Todos os pontos dentro do conjunto de dados especificado serão retornados com chamadas subsequentes para recuperar esse conjunto. 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 apenas inseridos, sem dados existentes substituídos.