Users.dataSources.datasets

Un conjunto de datos representa un contenedor de proyección de datos. No tienen información propia. Los conjuntos de datos representan un conjunto de datos de una fuente de datos particular. Un dato puede encontrarse en más de un conjunto de datos.

Si quieres ver una lista de los métodos para este recurso, consulta la sección final de esta página.

Representaciones 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
}
Nombre de la propiedad Valor Descripción Notas
dataSourceId string El ID del flujo de datos de la fuente de datos que creó los puntos en este conjunto de datos.
maxEndTimeNs long La hora de finalización más alta de todos los datos en esta representación, posiblemente parcial, del conjunto de datos. El tiempo se expresa en nanosegundos respecto del tiempo de entrenamiento. Esto también debe coincidir con la segunda parte del identificador del conjunto de datos.
minStartTimeNs long La hora de inicio más pequeña de todos los datos en esta representación, posiblemente parcial, del conjunto de datos. El tiempo se expresa en nanosegundos respecto del tiempo de entrenamiento. Esto también debe coincidir con la primera parte del identificador del conjunto de datos.
nextPageToken string Este token se establecerá cuando se reciba un conjunto de datos en respuesta a una solicitud GET y el conjunto de datos sea demasiado grande para incluirse en una única respuesta. Proporciona este valor en una solicitud GET posterior para mostrar la siguiente página de datos dentro de este conjunto de datos.
point[] list Una lista parcial de los datos contenidos en el conjunto de datos, ordenados por endTimeNanos. Esta lista se considera completa cuando se recupera un conjunto de datos pequeño y es parcial cuando se aplica parches a un conjunto de datos o se recupera un conjunto de datos demasiado grande para incluirlo en una sola respuesta.
point[].computationTimeMillis long NO USAR ESTE CAMPO. Se ignora y no se almacena.
point[].dataTypeName string Es el tipo de datos que define el formato de los valores en estos datos.
point[].endTimeNanos long Es la hora de finalización del intervalo que representa este dato, en nanosegundos y desde el ciclo de entrenamiento.
point[].modifiedTimeMillis long Indica la última vez que se modificó este dato. Es útil solo en contextos en los que enumeramos los cambios en los datos, en lugar de representar el estado actual de los datos.
point[].originDataSourceId string Si el dato se encuentra en un conjunto de datos de una fuente de datos derivada, este campo se propagará con el ID de flujo de la fuente de datos que creó el dato originalmente.

ADVERTENCIA: No utilices este campo solo para realizar la depuración. El valor de este campo, si se configura, es un detalle de la implementación y no se garantiza que permanezca coherente.
point[].rawTimestampNanos long La marca de tiempo sin procesar del SensorEvent original.
point[].startTimeNanos long Es la hora de inicio del intervalo que representa este dato, en nanosegundos y desde el ciclo de entrenamiento.
point[].value[] list Valores del campo de cada tipo de datos para el dato. Se espera que cada valor correspondiente a un campo de tipo de datos aparezca en el mismo orden con el que aparece el campo en el tipo de datos especificado en una fuente de datos.

Solo se propagará uno de los campos de número entero y punto flotante, según el valor de enumeración del formato en el campo de tipo de fuente de datos.

point[].value[].fpVal double Valor de punto flotante. Cuando se establece, no se deben establecer otros valores.
point[].value[].intVal integer Valor de número entero. Cuando se establece, no se deben establecer otros valores.
point[].value[].mapVal[] list Valor del mapa. El espacio de claves y las unidades válidos para el valor correspondiente de cada entrada deben documentarse como parte de la definición del tipo de datos. Las claves se deben mantener pequeñas siempre que sea posible. Es posible que se reduzca el muestreo de los flujos de datos con claves grandes y alta frecuencia de datos.
point[].value[].mapVal[].key string
point[].value[].mapVal[].value nested object
point[].value[].mapVal[].value.fpVal double Valor de punto flotante.
point[].value[].stringVal string Valor de string Cuando se establece, no se deben establecer otros valores. Las cadenas deben ser cortas siempre que sea posible. Es posible que los flujos de datos con valores de cadena grandes y una frecuencia alta de datos se reduzcan.

Métodos

borrar
Realiza una eliminación inclusiva de todos los datos cuyas horas de inicio y finalización tengan alguna superposición con el intervalo de tiempo especificado por el ID del conjunto de datos. Para la mayoría de los tipos de datos, se borrará todo el dato. Para los tipos de datos en los que el intervalo de tiempo representa un valor coherente (como com.google.activity.segment) y un dato se encuentra en cualquiera de los extremos del conjunto de datos, solo se borrará la parte superpuesta del dato.
get
Muestra un conjunto de datos que contiene todos los datos cuyas horas de inicio y finalización se superponen con el rango especificado de la hora de inicio mínima y la hora de finalización máxima del conjunto de datos. Específicamente, cualquier dato cuya hora de inicio es menor o igual que la hora de finalización del conjunto de datos y cuya hora de finalización es mayor o igual que la hora de inicio del conjunto de datos.
patch
Agrega datos a un conjunto de datos. No es necesario crear el conjunto de datos con anterioridad. Todos los puntos dentro del conjunto de datos dado se mostrarán con llamadas posteriores para recuperar este conjunto de datos. Los datos pueden pertenecer a más de un conjunto de datos.

Este método no usa semántica de parche: los datos proporcionados simplemente se insertan, sin reemplazar los datos existentes.