Users.dataSources: create

Tworzy nowe źródło danych, które jest unikalne we wszystkich źródłach danych należących do danemu użytkownikowi.

Źródło danych to unikalne źródło danych z czujnika. Źródła danych mogą udostępniać nieprzetworzonych danych z czujników sprzętowych w urządzeniach lokalnych lub towarzyszących. Ta może też ujawniać dane pochodne, utworzone przez przekształcenie lub scalenie innych danych źródeł. Dla tego samego typu danych może istnieć wiele źródeł danych. Wszystkie dane w każdym zbiorze danych wstawionym do interfejsu Fitness API lub z niego odczytywanym powiązane źródło danych.

Każde źródło danych generuje unikalny strumień aktualizacji zbioru danych z unikalny identyfikator źródła danych. Nie wszystkie zmiany w źródle danych mają wpływ na identyfikatora strumienia danych, tak aby dane zbierane przez zaktualizowane wersje tego samego wciąż można uznać, że aplikacja/urządzenie należą do tych samych danych źródła.

Źródła danych są identyfikowane za pomocą ciągu tekstowego generowanego przez serwer, na treść tworzonego źródła. dataStreamId nie należy ustawiać pola podczas wywoływania tej metody. it zostanie automatycznie wygenerowany przez serwer w prawidłowym formacie. Jeśli Wartość dataStreamId jest ustawiona, musi być zgodny z formatem określonym w który wygeneruje serwer. Ten format jest połączeniem niektórych pól z tagu źródła danych i ma określoną kolejność. Jeśli identyfikator nie jest zgodny, żądanie zakończy się niepowodzeniem.

Określenie obiektu DataType, który nie jest znanym typem (rozpoczyna się od „com.google.”) utworzy źródło danych z niestandardowym typem danych. Niestandardowe typy danych mogą odczytać tylko aplikacja, która je utworzyła. Niestandardowe typy danych zostaną wycofane. używają standardowych typów danych .

Oprócz pól źródła danych zawartych w identyfikatorze źródła danych narzędzie numer projektu dewelopera, który jest uwierzytelniany podczas tworzenia danych źródło. Ten numer projektu programisty jest zaciemniony podczas odczytu przez innych programistów odczytywanych publicznie typów danych. Wypróbuj

Żą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. me – do wskazują uwierzytelnionego użytkownika. Obecnie obsługiwana jest tylko wartość me obecnie się znajdujesz.

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

Treść żądania

W treści żądania podaj zasób Users.dataSources z tymi właściwościami:

Nazwa usługi Wartość Opis Uwagi
Właściwości wymagane
application nested object Informacje o aplikacji, która dostarcza do platformy dane z czujnika.
application.name string Nazwa tej aplikacji. Jest to wymagane w przypadku klientów REST, ale nie egzekwujemy niepowtarzalności tej nazwy. Jest ona udostępniana dla innych programistów, którzy chcą określić, który model REST utworzył aplikację lub źródło danych.
dataType nested object Typ danych określa schemat dla strumienia danych zbieranych przez interfejs Fitness API, wstawionych do nich lub zamawianych z niego.
dataType.field[] list Pole reprezentuje jeden wymiar danego typu danych.
dataType.field[].format string Różne obsługiwane formaty poszczególnych pól w typie danych.

Akceptowane wartości to:
  • „blob”
  • „floatList”
  • „floatPoint”
  • „integer”
  • „integerList”
  • „map”
  • „string”
dataType.field[].name string Definiuje nazwę i format danych. W przeciwieństwie do nazw typów danych nazwy pól nie muszą być przestrzeniami nazw i muszą być niepowtarzalne w obrębie typu danych.
dataType.name string Każdy typ danych ma unikalną nazwę z przestrzenią nazw. Wszystkie typy danych w przestrzeni nazw com.google są udostępniane w ramach platformy.
device nested object Przedstawienie zintegrowanego urządzenia (np. telefonu lub urządzenia do noszenia), które może przytrzymać czujniki.
device.manufacturer string Producent produktu lub sprzętu.
device.model string Widoczna dla użytkownika nazwa modelu urządzenia.
device.type string Stała określająca typ urządzenia.

Akceptowane wartości to:
  • „chestStrap”
  • „headMounted”
  • „phone”
  • „scale”
  • „smartDisplay”
  • „tablet”
  • „unknown”
  • „watch”
device.uid string Numer seryjny lub inny unikalny identyfikator sprzętu. To pole jest zaciemnione podczas odczytywania przez dowolnego klienta REST lub Androida, który nie utworzył źródła danych. Tylko twórca źródła danych zobaczy pole UID w czystej i normalnej formie.

Zaciemnianie kodu zapewnia równość. czyli dla dwóch identyfikatorów, jeśli id1 == id2, zaciemniony(id1) == zaciemniony(id2).

device.version string Ciąg znaków wersji sprzętu i oprogramowania urządzenia.
type string Stały opisujący typ źródła danych. Wskazuje, czy to źródło danych generuje nieprzetworzone czy pochodne dane.

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

Odpowiedź

Jeśli operacja się uda, metoda zwróci zasób User.dataSources w treści odpowiedzi.

Wypróbuj

Użyj poniższego eksploratora interfejsów API, aby wywołać tę metodę na bieżących danych i wyświetlić odpowiedź.