Cria uma nova fonte de dados exclusiva para todas as fontes que pertencem a
para este usuário.
Uma fonte de dados é uma fonte exclusiva de dados do sensor. As fontes de dados podem expor
dados brutos provenientes de sensores de hardware em dispositivos locais ou complementares. Eles
podem expor dados derivados, criados pela transformação ou mesclagem de outros dados
de dados. Várias fontes podem existir para o mesmo tipo de dados. Todos os dados
em cada conjunto de dados inserido ou lido na API Fitness tem uma
origem de dados associada.
Cada fonte de dados produz um fluxo exclusivo de atualizações do conjunto de dados, com um
identificador exclusivo da fonte de dados. Nem todas as alterações na fonte de dados afetam
ID do fluxo de dados, de modo que os dados coletados por versões atualizadas do mesmo
o aplicativo/dispositivo pertence aos mesmos dados
fonte.
As fontes de dados são identificadas por uma string gerada pelo servidor com base
no conteúdo da origem que está sendo criada. O dataStreamId
não deve ser definido ao invocar esse método. Ela
será gerado automaticamente pelo servidor com o formato correto. Se
um dataStreamId estiver definido, ele precisa corresponder ao formato do
servidor de dados seria gerado. Esse formato é uma combinação de alguns campos do
fonte de dados e tem uma ordem específica. Se não houver correspondência, a solicitação
vai falhar com um erro.
Especificar um tipo de dados que não é conhecido (começando com
"com.google.") vai criar uma DataSource com um tipo de dados personalizado.
Os tipos de dados personalizados só podem ser lidos pelo aplicativo que os criou.
Os tipos de dados personalizados foram descontinuados. usar tipos de dados padrão
como alternativa.
Além dos campos da fonte de dados incluídos no ID da fonte, o
número do projeto do desenvolvedor que é autenticado ao criar os dados
é incluída. O número do projeto do desenvolvedor fica ofuscado quando lido
por qualquer outro desenvolvedor que lê tipos de dados públicos.
Faça um teste agora.
Solicitação
Solicitação HTTP
POST https://www.googleapis.com/fitness/v1/users/userId/dataSources
Parâmetros
| Nome do parâmetro | Valor | Descrição |
|---|---|---|
| Parâmetros de caminho | ||
userId |
string |
Crie a fonte de dados para a pessoa identificada. Use o me para
indicar o usuário autenticado. Este item é compatível apenas com me
tempo de resposta.
|
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, informe 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 os dados do sensor na plataforma. | |
application.name |
string |
O nome deste aplicativo. Isso é obrigatório para clientes REST, mas não aplicamos a exclusividade desse nome. Ele é fornecido como uma questão de conveniência para outros desenvolvedores que querem identificar qual REST criou um aplicativo ou fonte de dados. | |
dataType |
nested object |
O tipo de dados define o esquema de um fluxo 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 suportados para cada campo em um tipo de dados.
Os valores aceitáveis são:
|
|
dataType.field[].name |
string |
Define o nome e o formato dos dados. Ao contrário dos nomes de tipo de dados, os nomes de campo não têm namespace e só precisam ser exclusivos dentro do tipo de dados. | |
dataType.name |
string |
Cada tipo de dados 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:
|
|
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, com dois IDs, if id1 == id2, expordo(id1) == oculto(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 a fonte de dados produz dados brutos ou derivados.
Os valores aceitáveis são:
|
|
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.