Users.dataSources: update

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. 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 Es el ID del 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 indican el usuario autenticado. Solo se admite me en esta tiempo.

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 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.
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.

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.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.
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"

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 se muestra a continuación para llamar a este método en datos en vivo y ver la respuesta.