Users.dataSources

Definicja unikalnego źródła danych z czujnika. Źródła danych mogą ujawniać 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 scalenie innych źródeł danych. Dla tego samego typu danych może istnieć wiele źródeł danych. Każdy punkt danych wstawiony do tej usługi lub z niej odczytywany ma powiązane źródło danych.

Źródło danych zawiera wystarczającą ilość informacji, aby można było jednoznacznie zidentyfikować dane, w tym urządzenie i aplikację, która zebrała lub przekształciła dane. Zawiera też przydatne metadane, takie jak wersje sprzętu i aplikacji oraz typ urządzenia.

Każde źródło danych generuje unikalny strumień danych z unikalnym identyfikatorem. Nie wszystkie zmiany w źródle danych mają wpływ na identyfikator strumienia, więc dane zbierane przez zaktualizowane wersje tej samej aplikacji/urządzenia nadal mogą być uznawane za należące do tego samego strumienia danych.

Listę metod dla tego zasobu znajdziesz na końcu tej strony.

Reprezentacje zasobów

{
  "dataStreamId": string,
  "name": string,
  "dataStreamName": string,
  "type": string,
  "dataType": {
    "name": string,
    "field": [
      {
        "name": string,
        "format": string,
        "optional": boolean
      }
    ]
  },
  "device": {
    "uid": string,
    "type": string,
    "version": string,
    "model": string,
    "manufacturer": string
  },
  "application": {
    "packageName": string,
    "version": string,
    "detailsUrl": string,
    "name": string
  },
  "dataQualityStandard": [
    string
  ]
}
Nazwa usługi Wartość Opis Uwagi
application nested object Informacje o aplikacji, która dostarcza do platformy dane z czujnika.
application.detailsUrl string Opcjonalny identyfikator URI, za pomocą którego można utworzyć link z powrotem do aplikacji.
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.
application.packageName string Nazwa pakietu tej aplikacji. Jest używany jako unikalny identyfikator w przypadku aplikacji na Androida, ale nie może być określony przez klienty REST. W identyfikatorach strumieni danych źródła danych w przypadku klientów REST zamiast wartości packageName będzie widoczny numer projektu programistycznego.
application.version string Wersja aplikacji. Pole należy aktualizować za każdym razem, gdy aplikacja zmienia się w sposób, który wpływa na obliczenia danych.
dataQualityStandard[] list NIE POPULUJ TEGO POLA. Nigdy nie jest wypełniane w odpowiedziach z platformy i ignorowane w zapytaniach. Zostanie ona całkowicie usunięta w przyszłej wersji.
dataStreamId string Unikalny identyfikator strumienia danych tworzonego przez to źródło danych. Identyfikator zawiera:

  • Producent, model i numer seryjny urządzenia fizycznego (UID).
  • Nazwa pakietu aplikacji lub jej nazwa. Nazwa pakietu jest używana, gdy źródło danych zostało utworzone przez aplikację na Androida. Numer projektu programisty jest używany, gdy źródło danych zostało utworzone przez klienta REST.
  • Typ źródła danych.
  • Nazwa strumienia źródła danych.
Pamiętaj, że nie wszystkie atrybuty źródła danych są używane jako część identyfikatora strumienia. W szczególności nie są używane wersje sprzętu ani aplikacji. Dzięki temu możemy zachować ten sam strumień przez aktualizacje wersji. Oznacza to też, że 2 obiekty DataSource mogą reprezentować ten sam strumień danych, nawet jeśli są różne.

Dokładny format identyfikatora strumienia danych utworzonego przez aplikację na Androida to: type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName

Dokładny format identyfikatora strumienia danych utworzonego przez klienta REST: type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName

Jeśli brakuje któregoś z opcjonalnych pól składających się na identyfikator strumienia danych, zostaną one pominięte w identyfikatorze strumienia danych. Minimalny prawidłowy identyfikator strumienia danych to: type:dataType.name:developer number project number

Numer projektu programisty oraz identyfikator UID urządzenia są zaciemnione podczas odczytywania danych przez klienta REST lub Androida, który nie utworzył źródła danych. Tylko twórca źródła danych zobaczy numer projektu programisty w jasnym i normalnym formacie. Oznacza to, że klient zobaczy inny zbiór wartości data_stream_id niż inny klient z innymi danymi logowania.

dataStreamName string Nazwa strumienia jednoznacznie identyfikuje to konkretne źródło danych wśród innych źródeł danych tego samego typu od tego samego producenta. Ustawianie nazwy strumienia jest opcjonalne, ale należy je wykonać, gdy aplikacja udostępnia 2 strumienie dla tego samego typu danych lub gdy urządzenie ma 2 równoważne czujniki.
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.field[].optional boolean
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.
name string Nazwa tego źródła danych widoczna dla użytkownika.
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”

Metody

utwórz
Tworzy nowe źródło danych, które jest niepowtarzalne 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.
usuń
Usuwa określone źródło danych. Żądanie zakończy się niepowodzeniem, jeśli dane zawiera dowolne punkty danych.
pobierz
Zwraca określone źródło danych.
list
Wyświetla listę wszystkich źródeł danych widocznych dla dewelopera za pomocą protokołu OAuth dostępnych zakresów. Ta lista nie jest wyczerpująca. użytkownik może mieć prywatny źródeł danych, które są widoczne tylko dla innych deweloperów, lub połączeń korzystających z w innych zakresach.
zaktualizuj
Aktualizuje podane źródło danych. dataStreamId, dataType, type, dataStreamName i Usługi: device z wyjątkiem version, Nie można zmienić.

Źródła danych są określane za pomocą atrybutu dataStreamId.