Users.dataSources: create

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 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 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. 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 para la persona identificada. Usa me para indicar el usuario autenticado. Por el 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 alimenta datos de sensores en la plataforma.
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.
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:
  • "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.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:
  • "chestStrap"
  • "headMounted"
  • "phone"
  • "scale"
  • "smartDisplay"
  • "tablet"
  • "unknown"
  • "watch"
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.
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:
  • "derived"
  • "raw"

Respuesta

Si se aplica correctamente, este método muestra un Users.dataSources resource en el cuerpo de la respuesta.

Pruébela.

Usa el Explorador de API que aparece a continuación para llamar a este método en datos activos y ver la respuesta.