Definición de una fuente única de datos del sensor. 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 este servicio tiene una fuente de datos asociada.
La fuente de datos contiene información suficiente para identificar sus datos de forma única, como el dispositivo de hardware y la aplicación que los recopiló o transformó. También contiene metadatos útiles, como el hardware y 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 transmisión, por lo que se puede considerar que los datos recopilados por las versiones actualizadas del mismo dispositivo o aplicación pertenecen al mismo flujo de datos.
Para obtener una lista de métodos relacionados con este recurso, consulta el 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 alimenta datos de sensores en la plataforma. | |
application.detailsUrl |
string |
Un URI opcional que se puede usar para establecer un vínculo con la aplicación. | |
application.name |
string |
El nombre de esta aplicación. Este paso es obligatorio para los clientes REST, pero no exigimos que este nombre sea único. Se proporciona para que otros desarrolladores que quieran identificar qué REST creó una aplicación o fuente de datos. | |
application.packageName |
string |
Nombre del paquete para esta aplicación. Se usa como identificador único cuando se crea mediante aplicaciones para Android, pero los clientes de REST no pueden especificarlo. Los clientes de REST tendrán su número de proyecto de desarrollador reflejado en los ID de flujo de datos de la fuente de datos, en lugar del packageName. | |
application.version |
string |
Versión de la aplicación. Debes actualizar este campo cada vez que la aplicación cambie de una forma que afecte el cálculo de los datos. | |
dataQualityStandard[] |
list |
NO COMPLETA ESTE CAMPO. Nunca se propaga en las 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 producido por esta fuente de datos. El identificador incluye:
El formato exacto del ID de flujo de datos creado por una aplicación para Android es el siguiente: type:dataType.name El formato exacto del ID de flujo de datos creado por un cliente de REST es: type:dataType.name Cuando falte alguno de los campos opcionales que conforman el ID de flujo de datos, se omitirán en el ID de flujo de datos. El número mínimo de ID de flujo de datos viable sería: type:dataType.name:developer project number Por último, el número de proyecto del programador y el UID del dispositivo se ofuscan cuando lo lee cualquier cliente de REST o Android que no creó la fuente de datos. Solo el creador de la fuente de datos verá el número del proyecto del programador 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 de la transmisión identifica de forma única esta fuente de datos específica entre otras fuentes de datos del mismo tipo del mismo productor subyacente. Establecer el nombre de transmisión es opcional, pero se debe hacer 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 para un flujo de datos que la API de Fitness recopila, inserta o consulta. | |
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 en un tipo de datos.
Los valores aceptables son los siguientes:
|
|
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 con espacio de nombres único. Todos los tipos de datos en el 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 |
Es el fabricante del producto o hardware. | |
device.model |
string |
Es el nombre del modelo visible para el usuario final del dispositivo. | |
device.type |
string |
Constante que representa el tipo de dispositivo.
Los valores aceptables son los siguientes:
|
|
device.uid |
string |
El número de serie u otro ID único del hardware. Este campo se ofusca cuando lo lee cualquier cliente de REST o Android que no creó la fuente de datos. Solo el creador de la fuente de datos verá el campo uid de forma clara y normal. La ofuscación preserva la igualdad, es decir, dados dos ID, si id1 == id2, ofuscados(id1) == ofuscados(id2). |
|
device.version |
string |
String de versión para el hardware o software del dispositivo. | |
name |
string |
Un nombre visible del usuario final para esta fuente de datos. | |
type |
string |
Constante que describe el tipo de esta fuente de datos. Indica si esta fuente de datos produce datos sin procesar o derivados.
Los valores aceptables son los siguientes:
|
Métodos
- crear
- Crea una fuente de datos nueva que es única entre todas las fuentes de datos que pertenecen a 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. 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 en cada conjunto de datos insertado en la API de Fitness o leído en ella tiene una fuente de datos asociada.
Cada fuente de datos produce un flujo único de actualizaciones de conjuntos de datos, con un identificador de fuente de datos único. No todos los cambios en la fuente de datos afectan el ID de flujo de datos, por lo que los datos recopilados por las versiones actualizadas del mismo dispositivo o aplicación se pueden considerar que pertenecen a la misma fuente de datos.
Las fuentes de datos se identifican mediante una string generada por el servidor, que se basa en el contenido de la fuente que se crea. No se debe establecer el campodataStreamId
cuando se invoca este método. El servidor lo generará automáticamente con el formato correcto. Si se configura undataStreamId
, debe coincidir con el formato que generará el servidor. Este formato es una combinación de algunos campos de la fuente de datos y tiene un orden específico. Si no coincide, la solicitud fallará y mostrará un error.
Si se especifica un DataType que no es un tipo conocido (comienza con &comt;com.google."), se creará un DataSource con un tipo de datos personalizado. Solo la aplicación que los creó puede leer los tipos de datos personalizados. Los tipos de datos personalizados están obsoletos; en su lugar, usa tipos de datos estándar.
Además de los campos de la fuente de datos incluidos en el ID de la fuente de datos, se incluye el número del proyecto de desarrollador que se autentica cuando se crea la fuente de datos. Este número de proyecto de desarrollador se ofusca cuando lo lee cualquier otro desarrollador que lea tipos de datos públicos. - borrar
- Borra la fuente de datos especificada. La solicitud fallará si la fuente de datos contiene datos.
- obtener
- Muestra la fuente de datos especificada.
- list
- Enumera todas las fuentes de datos que son visibles para el desarrollador, con los alcances de OAuth proporcionados. La lista no es exhaustiva; el usuario puede tener fuentes de datos privadas que solo son visibles para otros desarrolladores o llamadas que usan otros alcances.
- actualizar
- Actualiza la fuente de datos especificada. Las propiedades
dataStreamId
,dataType
,type
,dataStreamName
ydevice
, a excepción deversion
, no se pueden modificar.
Las fuentes de datos se identifican por sudataStreamId
.