Crea una fuente de datos nueva que sea única en 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, que se crean mediante la transformación o combinación de otras fuentes de datos. Pueden existir varias fuentes de datos para el mismo tipo de datos. Cada dato que se inserta en la API de Fitness o que se lee desde esta tiene una fuente de datos asociada.
Cada fuente de datos produce una transmisión única 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 de la misma aplicación o dispositivo pueden considerarse que pertenecen a la misma fuente de datos.
Las fuentes de datos se identifican con una string que genera el servidor, en función del contenido de la fuente que se crea. No se debe configurar el campo dataStreamId
cuando se invoca este método. El servidor lo generará automáticamente con el formato correcto. Si se configura un dataStreamId
, 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 especificas un DataType que no es un tipo conocido (que comienza con “com.google.”), se 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; en su lugar, usa los tipos de datos estándar.
Además de los campos de fuente de datos incluidos en el ID de la fuente de datos, se incluye el número de proyecto del desarrollador que se autentica cuando se crea la fuente de datos. Este número de proyecto del desarrollador se ofusca cuando lo lee cualquier otro desarrollador que lee tipos de datos públicos.
Pruébalo ahora.
Solicitud
Solicitud HTTP
POST https://www.googleapis.com/fitness/v1/users/userId/dataSources
Parámetros
Nombre del parámetro | Valor | Descripción |
---|---|---|
Parámetros de ruta de acceso | ||
userId |
string |
Crea la fuente de datos de la persona identificada. Usa me para indicar el usuario autenticado. En este momento, solo se admite me .
|
Autorización
Esta solicitud requiere autorización con al menos uno de los siguientes alcances:
Alcance |
---|
https://www.googleapis.com/auth/fitness.activity.write |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
Para obtener más información, consulta la página de autenticación y autorización.
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporciona un recurso Users.dataSources con las siguientes propiedades:
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
Propiedades obligatorias | |||
application |
nested object |
Información sobre una aplicación que envía datos de sensores a la plataforma. | |
application.name |
string |
Es el nombre de esta aplicación. Esto es obligatorio para los clientes REST, pero no aplicamos la exclusividad de este nombre. Se proporciona por conveniencia a otros desarrolladores que desean identificar qué REST creó una aplicación o una fuente de datos. | |
dataType |
nested object |
El tipo de datos define el esquema para un flujo de datos que recopila, inserta o consulta desde la Fitness API. | |
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 los campos no tienen espacios de nombres y solo deben ser únicos dentro del tipo de datos. | |
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 para el usuario final del dispositivo. | |
device.type |
string |
Es una constante que representa el tipo de dispositivo.
Los valores aceptables son los siguientes:
|
|
device.uid |
string |
Es el número de serie o algún otro ID único del hardware. Este campo se ofusca cuando lo lee un cliente de REST o Android que no creó 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, a partir de dos IDs, si id1 == id2, ofuscado(id1) == ofuscado(id2). |
|
device.version |
string |
Es la cadena de versión del hardware o software del dispositivo. | |
type |
string |
Es una 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:
|
Respuesta
Si se aplica correctamente, este método muestra un recurso Users.dataSources en el cuerpo de la respuesta.
Pruébalo
Usa el Explorador de APIs que aparece a continuación para llamar a este método con los datos en tiempo real y ver la respuesta.