Users.dataSources: update

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

As fontes de dados são identificadas pelo dataStreamId. Teste agora mesmo.

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 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, há suporte apenas para me.

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 a plataforma com dados do sensor.
application.name string O nome deste aplicativo. Isso é necessário para clientes REST, mas não aplicamos exclusividade desse nome. Ele é fornecido como uma questão de conveniência para outros desenvolvedores que gostariam de identificar qual REST criou um aplicativo ou uma fonte de dados.
dataStreamId string Um identificador exclusivo do fluxo de dados produzido por essa fonte de dados. O identificador inclui:

  • O fabricante, modelo e número de série (UID) do dispositivo físico
  • O nome do pacote do aplicativo. O nome do pacote é usado quando a fonte de dados foi criada por um app Android. O número do projeto do desenvolvedor é usado quando a fonte de dados foi criada por um cliente REST.
  • O tipo de fonte de dados.
  • Nome do fluxo da fonte de dados.
Nem todos os atributos da fonte de dados são usados como parte do identificador de stream. Especificamente, a versão do hardware ou do aplicativo não é usada. Isso nos permite preservar o mesmo fluxo por meio de atualizações de 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 um dos campos opcionais que compõem o ID do fluxo de dados está ausente, ele é omitido do ID do fluxo de dados. O ID viável mínimo do fluxo de dados 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 tenha criado a fonte de dados. Somente o criador da fonte de dados verá o número do projeto do desenvolvedor em formato claro e normal. Isso significa que um cliente vai notar um conjunto diferente de data_stream_ids de outro cliente com credenciais distintas.

dataType nested object O tipo de dados define o esquema de um fluxo de dados que estão sendo coletados, inseridos ou consultados com a 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 dos campos não têm namespace e só precisam ser exclusivos dentro do tipo de dados.
dataType.name string Cada tipo de dado tem um nome exclusivo e 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 um smartphone ou um 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 do 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 do hardware. Esse campo é ofuscado quando lido por qualquer cliente REST ou Android que não tenha criado 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, ofuscad(id1) == Avalied(id2).

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

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

Resposta

Se for bem-sucedido, esse 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.