Users.dataSources: update

Atualiza a fonte de dados especificada. As propriedades dataStreamId, dataType, type, dataStreamName e device, exceto version, não podem ser modificadas.

As fontes de dados são identificadas pela dataStreamId. Faça um teste.

Solicitação

Solicitação HTTP

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

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
dataSourceId string O ID do fluxo de dados da fonte de dados a ser atualizada.
userId string Atualize a fonte de dados da pessoa identificada. Use me para indicar o usuário autenticado. No momento, somente me é compatível.

Autorização

Esta solicitação requer autorização com pelo menos um dos seguintes escopos:

Escopo
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 mais informações, consulte a página de autenticação e autorização.

Corpo da solicitação

No corpo da solicitação, forneça um recurso Users.dataSources com as seguintes propriedades:

Nome da propriedade Valor Descrição Observações
Propriedades obrigatórias
application nested object Informações sobre um aplicativo que alimenta dados do sensor na plataforma.
application.name string O nome deste aplicativo. Isso é necessário para clientes REST, mas não aplicamos exclusividade desse nome. Esse recurso é de conveniência para outros desenvolvedores que querem identificar qual REST criou um aplicativo ou uma fonte de dados.
dataStreamId string Um identificador exclusivo do fluxo de dados produzido por esta fonte de dados. O identificador inclui o seguinte:

  • Fabricante, modelo e número de série (UID) do dispositivo físico.
  • O nome ou nome do pacote do aplicativo. O nome do pacote é usado quando a fonte de dados é criada por um app Android. Esse número é usado quando a fonte de dados foi criada por um cliente REST.
  • O tipo da fonte de dados.
  • O nome do fluxo da fonte de dados.
Nem todos os atributos da fonte de dados são usados como parte do identificador do stream. Em particular, a versão do hardware/aplicativo não é usada. Isso preserva o mesmo stream ao atualizar a versão. Isso também significa que dois objetos DataSource podem representar o mesmo fluxo de dados, mesmo que não sejam iguais.

O formato exato do ID do fluxo de dados criado por um aplicativo Android é: type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName

O formato exato do ID do fluxo de dados criado por um cliente REST é: type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName

Quando algum dos campos opcionais que compõem o ID do fluxo de dados estão ausentes, eles são omitidos do ID do fluxo. O ID do fluxo de dados mínimo viável seria: type:dataType.name:developer project number

Por fim, o número do projeto do desenvolvedor e o UID do dispositivo são ofuscados quando lidos por qualquer cliente REST ou Android que não criou a fonte de dados. Somente o criador da fonte de dados verá o número do projeto do desenvolvedor de forma clara e normal. Isso significa que o cliente verá um conjunto de data_stream_ids diferente de outro cliente com credenciais diferentes.

dataType nested object O tipo de dado define o esquema de um stream de dados que é coletado, inserido ou consultado na API Fitness.
dataType.field[] list Um campo representa uma dimensão de um tipo de dados.
dataType.field[].format string Os diferentes formatos compatíveis com cada campo em um tipo de dados.

Os valores aceitáveis são:
  • "blob"
  • "floatList"
  • "floatPoint"
  • "integer"
  • "integerList"
  • "map"
  • "string"
dataType.field[].name string Define o nome e o formato dos dados. Ao contrário dos nomes de tipos de dados, os nomes de campos não têm namespaces e só precisam ser exclusivos dentro do tipo de dados.
dataType.name string Cada tipo de dados tem um nome exclusivo com namespace. Todos os tipos de dados no namespace com.google são compartilhados como parte da plataforma.
device nested object Representação de um dispositivo integrado (como smartphone ou wearable) que pode conter sensores.
device.manufacturer string Fabricante do produto/hardware.
device.model string Nome do modelo visível para o usuário final para o dispositivo.
device.type string Uma constante que representa o tipo do dispositivo.

Os valores aceitáveis são:
  • "chestStrap"
  • "headMounted"
  • "phone"
  • "scale"
  • "smartDisplay"
  • "tablet"
  • "unknown"
  • "watch"
device.uid string O número de série ou outro ID exclusivo para o hardware. Esse campo é ofuscado quando lido por qualquer cliente REST ou Android que não criou a fonte de dados. Somente o criador da fonte de dados verá o campo uid em formato claro e normal.

A ofuscação preserva a igualdade, ou seja, considerando dois IDs, se id1 == id2, obfuscated(id1) == obfuscated(id2).

device.version string String da versão do hardware/software do dispositivo.
type string Uma constante que descreve o tipo dessa fonte de dados. Indica se essa fonte de dados produz dados brutos ou derivados.

Os valores aceitáveis são:
  • "derived"
  • "raw"

Resposta

Se for bem-sucedido, este método retornará um recurso Users.dataSources no corpo da resposta.

Confira!

Use o APIs Explorer abaixo para chamar esse método em dados ativos e ver a resposta.