Users.dataSources: update

Aktualizuje wybrane źródło danych. Nie można zmieniać właściwości dataStreamId, dataType, type, dataStreamName ani device z wyjątkiem właściwości version.

Źródła danych określa dataStreamId. Wypróbuj teraz

Żą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, który ma zostać zaktualizowany.
userId string Zaktualizuj źródło danych określonej osoby. Aby wskazać uwierzytelnionego użytkownika, użyj zasady me. Obecnie obsługiwany jest tylko typ me.

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 uwierzytelniania i autoryzacji.

Treść żądania

W treści żądania dodaj zasobów.UsersSources z tymi właściwościami:

Nazwa właściwości Wartość Opis Uwagi
Wymagane właściwości
application nested object Informacje o aplikacji, która dostarcza dane z czujników do platformy.
application.name string Nazwa tej aplikacji. Jest to wymagane w przypadku klientów REST, ale nie egzekwujemy unikalnych nazw. Inną opcją jest wygodne dla innych deweloperów, którzy chcą określić, który REST utworzył aplikację lub źródło danych.
dataStreamId string Niepowtarzalny identyfikator strumienia danych wygenerowanego przez to źródło danych. Identyfikator obejmuje:

  • Producent, model i numer seryjny urządzenia (UID).
  • Nazwa lub nazwa pakietu aplikacji. Nazwa pakietu jest używana, gdy źródło danych zostało utworzone przez aplikację na Androida. Numer projektu dewelopera jest używany, gdy źródło danych zostało utworzone przez klienta typu REST.
  • Typ źródła danych.
  • Nazwa strumienia danych.
Pamiętaj, że nie wszystkie atrybuty źródła danych są używane jako część identyfikatora strumienia. Zwłaszcza wersja sprzętu lub aplikacji nie jest używana. Pozwoli nam to zachować ten sam strumień za pomocą aktualizacji wersji. Oznacza to też, że dwa obiekty DataSource mogą przedstawiać 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 to type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName Najmniejszym identyfikatorem rzeczywistego strumienia danych jest: type:dataType.name:developer number number

Na koniec numer projektu dewelopera i identyfikator UID urządzenia są zaciemnione w przypadku odczytania go przez klienta REST lub Android, który nie utworzył źródła danych. Numer projektu dewelopera będzie widoczny w czytelnej i normalnej formie tylko dla twórcy źródła danych. Oznacza to, że klient zobaczy inny zestaw danych data_stream_ids niż inny klient z innymi danymi logowania.

dataType nested object Typ danych definiuje schemat strumienia danych zbieranych, wstawianych do zapytania lub wysyłanych z interfejsu Fitness API.
dataType.field[] list Pole reprezentuje jeden wymiar danego 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 są utworzone w przestrzeni nazw i muszą być unikalne w ramach danego typu danych.
dataType.name string Każdy typ danych ma niepowtarzalną nazwę. Wszystkie typy danych w przestrzeni nazw com.google są udostępniane w ramach platformy.
device nested object Prezentacja zintegrowanego urządzenia (np. telefonu lub urządzenia do noszenia) z czujnikami.
device.manufacturer string Producent produktu/sprzętu.
device.model string Nazwa modelu widoczna dla użytkownika na urządzeniu.
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. Pole jest zaciemnione w przypadku odczytu przez klienta REST lub Android, który nie utworzył źródła danych. Tylko twórca źródła danych zobaczy pole uid w przejrzystym i normalnym formacie.

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

device.version string Ciąg znaków dotyczący wersji oprogramowania urządzenia.
type string Stała z opisującym typem tego źródła danych. Wskazuje, czy źródło danych generuje nieprzetworzone czy uzyskane dane.

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

Odpowiedź

Jeśli ta metoda się powiedzie, ta metoda zwróci w treści odpowiedź zasób Users.dataSources.

Wypróbuj

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