Users.dataSources: create

Tworzy nowe źródło danych, które będzie unikalne we wszystkich źródłach danych należących do tego użytkownika.

Źródło danych to niepowtarzalne źródło danych z czujnika. Źródła danych mogą udostępniać nieprzetworzone dane pochodzące z czujników sprzętowych na urządzeniach lokalnych lub towarzyszących. Mogą też udostępniać dane pochodne utworzone przez przekształcenie lub scalanie innych źródeł danych. Ten sam typ danych może obejmować wiele źródeł danych. Każdy punkt danych w każdym zbiorze danych wstawiony do interfejsu Fitness API lub z niego odczytywany ma powiązane źródło danych.

Każde źródło danych generuje unikalny strumień aktualizacji zbioru danych z unikalnym identyfikatorem źródła danych. Nie wszystkie zmiany w źródle danych wpływają na identyfikator strumienia danych. Dlatego informacje zbierane przez zaktualizowane wersje tej samej aplikacji lub tego samego urządzenia można nadal uznać za należące do tego samego źródła.

Źródła danych są identyfikowane za pomocą ciągu tekstowego wygenerowanego przez serwer na podstawie treści tworzonego źródła. Podczas wywoływania tej metody nie należy ustawiać pola dataStreamId. Zostanie on automatycznie wygenerowany przez serwer w prawidłowym formacie. Jeśli ustawiono dataStreamId, musi on być zgodny z formatem wygenerowanym przez serwer. Ten format stanowi kombinację niektórych pól ze źródła danych i ma określoną kolejność. Jeśli te dane nie są zgodne, żądanie zakończy się błędem.

Wskazanie nieznanego typu danych (zaczynającego się od „com.google.”) spowoduje utworzenie źródła danych z niestandardowym typem danych. Niestandardowe typy danych są odczytywane tylko przez aplikację, która je utworzyła. Niestandardowe typy danych są wycofane. Zamiast nich używaj standardowych typów danych.

Oprócz pól źródła danych uwzględnionych w identyfikatorze źródła danych podany jest też numer projektu dewelopera, który jest uwierzytelniany podczas tworzenia źródła danych. Ten numer projektu dewelopera jest zaciemniony podczas odczytywania innego programisty, który odczytuje typy danych publicznych. Wypróbuj teraz

Prośba

Żądanie HTTP

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

Parametry

Nazwa parametru Wartość Opis
Parametry ścieżki
userId string Utwórz źródło danych dla identyfikowanej 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.
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ź.