Users.dataSources: update

Aktualizuje podane źródło danych. dataStreamId, dataType, type, dataStreamName i Usługi: device z wyjątkiem version, Nie można zmienić.

Źródła danych są określane za pomocą atrybutu dataStreamId. Wypróbuj

Żądanie

Żądanie HTTP

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

Parametry

Nazwa parametru Wartość Opis
Parametry ścieżki
dataSourceId string Identyfikator strumienia danych ze źródła danych do zaktualizowania.
userId string Zaktualizuj źródło danych zidentyfikowanej osoby. me – do wskazują uwierzytelnionego użytkownika. Obecnie obsługiwana jest tylko wartość me obecnie się znajdujesz.

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów:

Zakres
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

Więcej informacji znajdziesz na stronie dotyczącej uwierzytelniania i autoryzacji.

Treść żądania

W treści żądania podaj zasób Users.dataSources z tymi właściwościami:

Nazwa usługi Wartość Opis Uwagi
Właściwości wymagane
application nested object Informacje o aplikacji, która dostarcza do platformy dane z czujnika.
application.name string Nazwa tej aplikacji. Jest to wymagane w przypadku klientów REST, ale nie egzekwujemy niepowtarzalności tej nazwy. Jest ona udostępniana dla innych programistów, którzy chcą określić, który model REST utworzył aplikację lub źródło danych.
dataStreamId string Unikalny identyfikator strumienia danych tworzonego przez to źródło danych. Identyfikator zawiera:

  • Producent, model i numer seryjny urządzenia fizycznego (UID).
  • Nazwa pakietu aplikacji lub jej nazwa. Nazwa pakietu jest używana, gdy źródło danych zostało utworzone przez aplikację na Androida. Numer projektu programisty jest używany, gdy źródło danych zostało utworzone przez klienta REST.
  • Typ źródła danych.
  • Nazwa strumienia źródła danych.
Pamiętaj, że nie wszystkie atrybuty źródła danych są używane jako część identyfikatora strumienia. W szczególności nie są używane wersje sprzętu ani aplikacji. Dzięki temu możemy zachować ten sam strumień przez aktualizacje wersji. Oznacza to też, że 2 obiekty DataSource mogą reprezentować ten sam strumień danych, nawet jeśli są różne.

Dokładny format identyfikatora strumienia danych utworzonego przez aplikację na Androida to: type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName

Dokładny format identyfikatora strumienia danych utworzonego przez klienta REST: type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName

Jeśli brakuje któregoś z opcjonalnych pól składających się na identyfikator strumienia danych, zostaną one pominięte w identyfikatorze strumienia danych. Minimalny prawidłowy identyfikator strumienia danych to: type:dataType.name:developer number project number

Numer projektu programisty oraz identyfikator UID urządzenia są zaciemnione podczas odczytywania danych przez klienta REST lub Androida, który nie utworzył źródła danych. Tylko twórca źródła danych zobaczy numer projektu programisty w jasnym i normalnym formacie. Oznacza to, że klient zobaczy inny zbiór wartości data_stream_id niż inny klient z innymi danymi logowania.

dataType nested object Typ danych określa schemat dla strumienia danych zbieranych przez interfejs Fitness API, wstawionych do nich lub zamawianych z niego.
dataType.field[] list Pole reprezentuje jeden wymiar danego typu danych.
dataType.field[].format string Różne obsługiwane formaty poszczególnych pól w typie danych.

Akceptowane wartości to:
  • „blob”
  • „floatList”
  • „floatPoint”
  • „integer”
  • „integerList”
  • „map”
  • „string”
dataType.field[].name string Definiuje nazwę i format danych. W przeciwieństwie do nazw typów danych nazwy pól nie muszą być przestrzeniami nazw i muszą być niepowtarzalne w obrębie typu danych.
dataType.name string Każdy typ danych ma unikalną nazwę z przestrzenią nazw. Wszystkie typy danych w przestrzeni nazw com.google są udostępniane w ramach platformy.
device nested object Przedstawienie zintegrowanego urządzenia (np. telefonu lub urządzenia do noszenia), które może przytrzymać czujniki.
device.manufacturer string Producent produktu lub sprzętu.
device.model string Widoczna dla użytkownika nazwa modelu urządzenia.
device.type string Stała określająca typ urządzenia.

Akceptowane wartości to:
  • „chestStrap”
  • „headMounted”
  • „phone”
  • „scale”
  • „smartDisplay”
  • „tablet”
  • „unknown”
  • „watch”
device.uid string Numer seryjny lub inny unikalny identyfikator sprzętu. To pole jest zaciemnione podczas odczytywania przez dowolnego klienta REST lub Androida, który nie utworzył źródła danych. Tylko twórca źródła danych zobaczy pole UID w czystej i normalnej formie.

Zaciemnianie kodu zapewnia równość. czyli dla dwóch identyfikatorów, jeśli id1 == id2, zaciemniony(id1) == zaciemniony(id2).

device.version string Ciąg znaków wersji sprzętu i oprogramowania urządzenia.
type string Stały opisujący typ źródła danych. Wskazuje, czy to źródło danych generuje nieprzetworzone czy pochodne dane.

Akceptowane wartości to:
  • „derived”
  • „raw”

Odpowiedź

Jeśli operacja się uda, metoda zwróci zasób User.dataSources w treści odpowiedzi.

Wypróbuj

Użyj poniższego eksploratora interfejsów API, aby wywołać tę metodę na bieżących danych i wyświetlić odpowiedź.