Users.dataSources: update

Aktualizuje określone źródło danych. Nie można modyfikować właściwości dataStreamId, dataType, type, dataStreamName i device (z wyjątkiem właściwości version).

Źródła danych są identyfikowane za pomocą atrybutu dataStreamId. Wypróbuj teraz

Prośba

Żą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 dotyczące zidentyfikowanej osoby. Użyj me, aby wskazać uwierzytelnionego użytkownika. Obecnie obsługiwana jest tylko wartość me.

Upoważnienie

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 Uwierzytelnianie i autoryzacja.

Treść żądania

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

nazwa usługi, Wartość Opis Notatki
Właściwości wymagane
application nested object Informacje o aplikacji, która dostarcza dane z czujników na platformę.
application.name string Nazwa tej aplikacji. Jest to wymagane w przypadku klientów REST, ale nie wymuszamy unikalności tej nazwy. Udostępniamy ją dla wygody innych programistów, którzy chcą określić, który interfejs REST utworzył aplikację lub źródło danych.
dataStreamId string Unikalny identyfikator strumienia danych utworzonego przez to źródło danych. Identyfikator zawiera:

  • Producent, model i numer seryjny (UID) urządzenia fizycznego.
  • Nazwa pakietu aplikacji. Nazwa pakietu jest używana, gdy źródło danych zostało utworzone przez aplikację na Androida. Numer projektu programisty jest używany podczas tworzenia źródła danych 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. Szczególnie nieużywana jest wersja sprzętu/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 nie są sobie równe.

Dokładny format identyfikatora strumienia danych utworzonego przez aplikację na Androida: 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 będzie brak jakichkolwiek opcjonalnych pól składających się na identyfikator strumienia danych, zostanie ono pominięte w identyfikatorze strumienia danych. Minimalny prawidłowy identyfikator strumienia danych to: type:dataType.name:numer projektu dewelopera

Numer projektu dewelopera i identyfikator UID urządzenia są zaciemniane podczas odczytu przez dowolnego klienta REST lub Androida, który nie utworzył źródła danych. Tylko twórca źródła danych zobaczy numer projektu dewelopera w czytelnej i normalnej formie. Oznacza to, że klient zobaczy inny zestaw identyfikatorów data_stream_id niż inny klient z innymi danymi logowania.

dataType nested object Typ danych określa schemat strumienia danych, które są zbierane przez interfejs Fitness API, wstawiane do niego lub odbierane z niego.
dataType.field[] list Pole reprezentuje jeden wymiar typu danych.
dataType.field[].format string Różne obsługiwane formaty dla każdego pola w typie danych.

Akceptowane wartości:
  • "blob"
  • "floatList"
  • "floatPoint"
  • "integer"
  • "integerList"
  • "map"
  • "string"
dataType.field[].name string Określa nazwę i format danych. W przeciwieństwie do nazw typów danych nazwy pól nie mają przestrzeni nazw i muszą być tylko unikalne w obrębie danego typu danych.
dataType.name string Każdy typ danych ma unikalną nazwę z przestrzenią nazw. W ramach platformy udostępniane są wszystkie typy danych znajdujące się w przestrzeni nazw com.google.
device nested object Przedstawienie zintegrowanego urządzenia (np. telefonu lub urządzenia do noszenia), które może przechowywać czujniki.
device.manufacturer string Producent produktu lub sprzętu.
device.model string Nazwa modelu urządzenia widoczna dla użytkownika.
device.type string Stała reprezentująca typ urządzenia.

Akceptowane wartości:
  • "chestStrap"
  • "headMounted"
  • "phone"
  • "scale"
  • "smartDisplay"
  • "tablet"
  • "unknown"
  • "watch"
device.uid string Numer seryjny lub inny unikalny identyfikator sprzętu. To pole jest zaciemniane podczas odczytu przez dowolnego klienta REST lub Androida, który nie utworzył źródła danych. Pole UID będzie widoczne tylko dla twórcy źródła danych.

Zaciemnianie kodu zachowuje równość, czyli gdy podano 2 identyfikatory, jeśli id1 == id2, zaciemniony(id1) == zaciemniony(id2).

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

Akceptowane wartości:
  • "derived"
  • "raw"

Odpowiedź

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

Wypróbuj

Użyj eksploratora interfejsów API poniżej, aby wywołać tę metodę na aktywnych danych i zobaczyć odpowiedź.