Users.dataSources

Definición de una fuente única de datos de sensores. Las fuentes de datos pueden exponer datos sin procesar provenientes de sensores de hardware en dispositivos locales o complementarios. También pueden exponer datos derivados, creados mediante la transformación o combinación de otras fuentes de datos. Puede haber varias fuentes de datos para el mismo tipo de datos. Cada dato que se inserta en este servicio o se lee desde él tiene una fuente de datos asociada.

La fuente de datos contiene suficiente información para identificar sus datos de manera inequívoca, incluido el dispositivo de hardware y la aplicación que recopiló o transformó los datos. También contiene metadatos útiles, como el hardware, las versiones de la aplicación y el tipo de dispositivo.

Cada fuente de datos produce un flujo de datos único con un identificador único. No todos los cambios en la fuente de datos afectan el identificador de flujo, por lo que los datos recopilados por las versiones actualizadas de la misma aplicación o dispositivo aún se pueden considerar que pertenecen al mismo flujo de datos.

Para obtener una lista de métodos para este recurso, consulta al final de esta página.

Representaciones de recursos

{
  "dataStreamId": string,
  "name": string,
  "dataStreamName": string,
  "type": string,
  "dataType": {
    "name": string,
    "field": [
      {
        "name": string,
        "format": string,
        "optional": boolean
      }
    ]
  },
  "device": {
    "uid": string,
    "type": string,
    "version": string,
    "model": string,
    "manufacturer": string
  },
  "application": {
    "packageName": string,
    "version": string,
    "detailsUrl": string,
    "name": string
  },
  "dataQualityStandard": [
    string
  ]
}
Nombre de la propiedad Valor Descripción Notas
application nested object Información sobre una aplicación que envía datos de sensores a la plataforma.
application.detailsUrl string Un URI opcional que se puede usar para volver a la aplicación.
application.name string Es el nombre de esta aplicación. Esto es obligatorio para los clientes REST, pero no aplicamos este nombre de unicidad. Se proporciona por conveniencia para otros desarrolladores que quieran identificar qué REST creó una aplicación o una fuente de datos.
application.packageName string Nombre del paquete de esta aplicación. Se usa como identificador único cuando lo crean aplicaciones para Android, pero los clientes REST no pueden especificarlo. En los clientes de REST, el número de proyecto del desarrollador se reflejará en los IDs de flujo de datos de la fuente de datos, en lugar de en packageName.
application.version string Es la versión de la aplicación. Debes actualizar este campo cada vez que la aplicación cambie de una manera que afecte el cálculo de los datos.
dataQualityStandard[] list NO COMPLETAS ESTE CAMPO. Nunca se propaga en respuestas de la plataforma y se ignora en las consultas. Se quitará por completo en una versión futura.
dataStreamId string Es un identificador único para el flujo de datos que produce esta fuente de datos. El identificador incluye los siguientes elementos:

  • El fabricante, el modelo y el número de serie (UID) del dispositivo físico.
  • El nombre o el nombre del paquete de la aplicación. El nombre del paquete se usa cuando una aplicación para Android creó la fuente de datos. El número de proyecto del desarrollador se usa cuando un cliente REST crea la fuente de datos.
  • Es el tipo de fuente de datos.
  • Nombre del flujo de la fuente de datos.
Ten en cuenta que no todos los atributos de la fuente de datos se utilizan como parte del identificador de transmisión. En particular, la versión del hardware o de la aplicación no se utiliza. Esto nos permite conservar la misma transmisión a través de actualizaciones de versión. Esto también significa que dos objetos DataSource pueden representar el mismo flujo de datos incluso si no son iguales.

El formato exacto del ID del flujo de datos que crea una aplicación para Android es el siguiente: type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName

El formato exacto del ID del flujo de datos que crea un cliente REST es el siguiente: type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName

Cuando falte alguno de los campos opcionales que componen el ID del flujo de datos, se omitirán del ID del flujo de datos. El ID de flujo de datos mínimo viable sería el siguiente: type:dataType.name:número de proyecto del desarrollador

Por último, el número del proyecto del desarrollador y el UID del dispositivo se ofuscan cuando cualquier cliente de REST o Android que no creó la fuente de datos los lee. Solo el creador de la fuente de datos verá el número del proyecto del desarrollador de forma clara y normal. Esto significa que un cliente verá un conjunto diferente de data_stream_ids que otro cliente con credenciales distintas.

dataStreamName string El nombre del flujo identifica de forma única esta fuente de datos en particular entre otras fuentes de datos del mismo tipo del mismo productor subyacente. Configurar el nombre de transmisión es opcional, pero se debe realizar cada vez que una aplicación expone dos transmisiones para el mismo tipo de datos o cuando un dispositivo tiene dos sensores equivalentes.
dataType nested object El tipo de datos define el esquema de un flujo de datos que recopila, inserta o consulta desde la API de Fitness.
dataType.field[] list Un campo representa una dimensión de un tipo de datos.
dataType.field[].format string Los diferentes formatos admitidos para cada campo de un tipo de datos.

Los valores aceptables son los siguientes:
  • "blob"
  • "floatList"
  • "floatPoint"
  • "integer"
  • "integerList"
  • "map"
  • "string"
dataType.field[].name string Define el nombre y el formato de los datos. A diferencia de los nombres de tipos de datos, los nombres de campos no tienen espacios de nombres y solo deben ser únicos dentro del tipo de datos.
dataType.field[].optional boolean
dataType.name string Cada tipo de datos tiene un nombre único con espacio de nombres. Todos los tipos de datos del espacio de nombres com.google se comparten como parte de la plataforma.
device nested object Representación de un dispositivo integrado (como un teléfono o un wearable) que puede contener sensores.
device.manufacturer string Fabricante del producto o hardware
device.model string Es el nombre del modelo visible del usuario final para el dispositivo.
device.type string Una constante que representa el tipo del dispositivo.

Los valores aceptables son los siguientes:
  • "chestStrap"
  • "headMounted"
  • "phone"
  • "scale"
  • "smartDisplay"
  • "tablet"
  • "unknown"
  • "watch"
device.uid string Es el número de serie o algún otro ID único del hardware. Este campo se ofusca cuando lo lee cualquier cliente de REST o Android que no haya creado la fuente de datos. Solo el creador de la fuente de datos verá el campo de UID de forma clara y normal.

La ofuscación preserva la igualdad. es decir, con dos IDs, si id1 == id2, ofuscado(id1) == ofuscado(id2).

device.version string Es la cadena de versión para el hardware o software del dispositivo.
name string Es un nombre visible para el usuario final de esta fuente de datos.
type string Es una constante que describe el tipo de esta fuente de datos. Indica si esta fuente de datos produce datos derivados o sin procesar.

Los valores aceptables son los siguientes:
  • "derived"
  • "raw"

Métodos

crear
Crea una fuente de datos nueva que es única en todas las fuentes de datos que pertenecen. para este usuario.

Una fuente de datos es una fuente única de datos de sensores. Las fuentes de datos pueden exponer datos sin procesar provenientes de sensores de hardware en dispositivos locales o complementarios. Ellas también pueden exponer datos derivados, creados mediante la transformación o combinación de otros datos fuentes de datos. Puede haber varias fuentes de datos para el mismo tipo de datos. Todos los datos punto en cada conjunto de datos insertado o leído desde la Fitness API tiene un fuente de datos asociada.

Cada fuente de datos produce un flujo único de actualizaciones de conjuntos de datos, con un único identificador de fuente de datos. No todos los cambios en la fuente de datos afectan un ID de flujo de datos, de modo que los datos recopilados por las versiones actualizadas del mismo todavía se puede considerar que la aplicación o el dispositivo pertenecen a los mismos datos fuente.

Las fuentes de datos se identifican usando una cadena generada por el servidor, basada sobre el contenido de la fuente que se crea. El dataStreamId no se deben configurar cuando se invoca este método. Integra el servidor generará automáticamente con el formato correcto. Si se establece una dataStreamId, debe coincidir con el formato en el que que genera el servidor. Este formato es una combinación de algunos campos del fuente de datos y tiene un orden específico. Si no coincide, la solicitud fallará con un error.

Especificar un tipo de datos que no sea conocido (empieza por "com.google.") creará una DataSource con un tipo de datos personalizado. Solo la aplicación que creó los tipos de datos personalizados puede leerlos. Los tipos de datos personalizados están obsoletos. usan tipos de datos estándar en su lugar.

Además de los campos de fuente de datos incluidos en el ID de fuente de datos, el el número de proyecto del desarrollador que se autentica al crear los datos si la fuente está incluida. Este número de proyecto del desarrollador se ofusca cuando se lee por cualquier otro desarrollador que lea los tipos de datos públicos.
borrar
Borra la fuente de datos especificada. La solicitud fallará si los datos fuente contiene puntos de datos.
get
Muestra la fuente de datos especificada.
list
Enumera todas las fuentes de datos que son visibles para el desarrollador con el ID de OAuth. y los permisos de acceso proporcionados. La lista no es exhaustiva. es posible que el usuario tenga acceso fuentes de datos que solo son visibles para otros desarrolladores, o llamadas mediante otros permisos.
actualización
Actualiza la fuente de datos especificada. El elemento dataStreamId dataType, type, dataStreamName y Propiedades device, excepto version, no se puede modificar.

Las fuentes de datos se identifican por su dataStreamId.