Users.dataSources: update

Actualiza la fuente de datos especificada. Las propiedades dataStreamId, dataType, type, dataStreamName y device, a excepción de version, no se pueden modificar.

Las fuentes de datos se identifican por su dataStreamId. Pruébalo ahora.

Solicitud

Solicitud HTTP

PUT https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId

Parámetros

Nombre del parámetro Valor Descripción
Parámetros de ruta de acceso
dataSourceId string El ID de flujo de datos de la fuente de datos que se actualizará.
userId string Actualiza la fuente de datos de 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.
dataStreamId string Es un identificador único para el flujo de datos producido por esta fuente de datos. El identificador incluye:

  • El fabricante, el modelo y el número de serie (UID) del dispositivo físico
  • El nombre o nombre del paquete de la aplicación. El nombre del paquete se usa cuando una fuente de datos se creó con una aplicación de Android. El número de proyecto del desarrollador se usa cuando un cliente REST crea la fuente de datos.
  • El tipo de fuente de datos.
  • El nombre de la transmisión de la fuente de datos.
Ten en cuenta que no todos los atributos de la fuente de datos se usan como parte del identificador de transmisión. En particular, no se usa la versión del hardware o de la aplicación. Esto nos permite conservar la misma transmisión a través de actualizaciones de versiones. 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 de flujo de datos creado por 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 de flujo de datos creado por un cliente de REST es: type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName

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.

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.