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:
|
|
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:
|
|
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:
|
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ź.