Users.dataSources.datasets

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

Para obtener una lista de métodos relacionados con este recurso, consulta el 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 de flujo de datos de la fuente de datos que creó los puntos en este conjunto de datos.
maxEndTimeNs long Es la hora de finalización más grande de todos los datos en esta posible representación parcial del conjunto de datos. El tiempo es en nanosegundos de la época. También debe coincidir con la segunda parte del identificador del conjunto de datos.
minStartTimeNs long Es la hora de inicio más pequeña de todos los puntos de datos en esta posible representación parcial del conjunto de datos. El tiempo es en nanosegundos de la época. 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 sola 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 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 parcial cuando se aplica un parche o 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 El tipo de datos que define el formato de los valores en este dato.
point[].endTimeNanos long La hora de finalización del intervalo que representa este dato, en nanosegundos desde el ciclo de entrenamiento.
point[].modifiedTimeMillis long Indica la última vez que se modificó este dato. Es útil solo en los contextos en los que se enumeran los cambios de datos, en lugar de representar su estado actual.
point[].originDataSourceId string Si el dato está contenido en un conjunto de datos para una fuente de datos derivada, este campo se propagará con el ID de flujo de fuente de datos que creó el dato originalmente.

ADVERTENCIA: No uses este campo más que la depuración. Si se establece, el valor de este campo es un detalle de implementación y no se garantiza que siga siendo coherente.
point[].rawTimestampNanos long La marca de tiempo sin procesar del SensorEvent original.
point[].startTimeNanos long La hora de inicio del intervalo representado por este dato, en nanosegundos desde el ciclo de entrenamiento.
point[].value[] list Valores de cada campo de tipo de datos para el dato. Se espera que cada valor correspondiente a un campo de tipo de datos ocurra en el mismo orden en el que se enumera 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 de punto flotante, según el valor de enumeración de formato en el campo de tipo de fuente de datos.

point[].value[].fpVal double Valor de punto flotante. Cuando se configura, no se deben establecer otros valores.
point[].value[].intVal integer Valor entero. Cuando se configura, no se deben establecer otros valores.
point[].value[].mapVal[] list Valor del mapa. El espacio de claves y las unidades válidas para el valor correspondiente de cada entrada deben documentarse como parte de la definición del tipo de datos. Las claves deben ser pequeñas siempre que sea posible. Es posible que se reduzcan las muestras de los flujos de datos con claves grandes y de alta frecuencia.
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 configura, no se deben establecer otros valores. Las strings deben ser pequeñas siempre que sea posible. Es posible que se realicen muestreos descendentes de transmisiones de datos con valores de string grandes y frecuencia de datos alta.

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 período 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 período representa un valor coherente (como com.google.activity.segment) y un dato se extiende a cualquiera de los extremos del conjunto de datos, solo se borrará la parte superpuesta del dato.
obtener
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 y la hora de finalización máximas del conjunto de datos. En particular, cualquier dato cuya hora de inicio sea menor o igual que la hora de finalización del conjunto de datos y cuya hora de finalización sea mayor o igual que la hora de inicio del conjunto de datos.
parche
Agrega puntos de datos a un conjunto de datos. No es necesario crear el conjunto de datos con anterioridad. Todos los puntos dentro del conjunto de datos determinado 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 la semántica de parches: los datos proporcionados solo se insertan y no se reemplazan los datos existentes.