Users.dataSources: create

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