Tworzy nowe źródło danych, które jest unikalne dla wszystkich źródeł danych należących do tego użytkownika.
Źródło danych jest niepowtarzalnym źródłem danych z czujników. Źródła danych mogą ujawniać nieprzetworzone dane z czujników na urządzeniach lokalnych lub towarzyszących. Może też udostępniać dane uzyskane, przekształcając lub scalając inne źródła danych. Dla tego samego typu danych może być wiele źródeł danych. Każdy punkt danych w każdym zbiorze danych, który jest umieszczony w interfejsie 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, więc dane zbierane przez zaktualizowane wersje tej samej aplikacji lub tego samego urządzenia mogą być nadal uznawane za przypisane do tego samego źródła danych.
Źródła danych są identyfikowane na podstawie tekstu wygenerowanego przez serwer na podstawie zawartości tworzonego źródła. Podczas wywoływania tej metody nie należy ustawiać pola dataStreamId
. Zostanie wygenerowany automatycznie przez serwer w prawidłowym formacie. Jeśli zasada jest ustawiona na dataStreamId
, musi ona odpowiadać formatowi generowanemu przez serwer. Ten format stanowi kombinację niektórych pól ze źródła danych i ma określoną kolejność. Jeśli nie uda się, żądanie zakończy się błędem.
Określenie typu danych, który nie jest znany (zaczyna się od &&tt;com.google."), spowoduje utworzenie źródła danych z niestandardowym typem danych.
Niestandardowe typy danych mogą odczytywać tylko te aplikacje, które je utworzyły.
Typy danych niestandardowych zostały wycofane. Użyj standardowych typów danych.
W polu źródła danych uwzględnionego w identyfikatorze źródła danych uwzględniono numer projektu dewelopera, który jest uwierzytelniony podczas tworzenia źródła. Numer projektu dewelopera jest zaciemniony, jeśli odczytuje go inny typ danych publicznych.
Wypróbuj teraz
Żądanie
Żą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 zidentyfikowanej 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. | |
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:
|
|
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:
|
|
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:
|
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ź.