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. 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 wstawiony do usługi lub z niej odczytywany ma powiązane źródło danych.

Źródło danych zawiera wystarczającą ilość informacji, aby jednoznacznie identyfikować dane, w tym informacje o sprzęcie i aplikacji, która zbiera lub przekształca te dane. Zawiera ona też przydatne metadane, np. wersję sprzętu i aplikacji oraz typ urządzenia.

Każde źródło danych tworzy unikalny strumień danych z unikalnym identyfikatorem. Nie wszystkie zmiany w źródle danych wpływają na identyfikator strumienia, więc dane zebrane przez zaktualizowane wersje tej samej aplikacji lub tego samego urządzenia mogą być nadal uznawane za przypisane 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 właściwości	Wartość	Opis	Uwagi
application	nested object	Informacje o aplikacji, która dostarcza dane z czujników do platformy.
application.detailsUrl	string	Opcjonalny identyfikator URI, którego można użyć do połączenia z aplikacją.
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.
application.packageName	string	Nazwa pakietu tej aplikacji. Używa się go jako unikalnego identyfikatora podczas tworzenia przez aplikacje na Androida, ale nie można go określić przez klientów typu REST. Klienty REST będą miały widoczny numer projektu w identyfikatorze strumienia danych, a nie identyfikator pakiety.
application.version	string	Wersja aplikacji. Musisz zaktualizować to pole za każdym razem, gdy aplikacja zmieni się w sposób, który ma wpływ na obliczanie danych.
dataQualityStandard[]	list	NIE wypełniaj tego pola. Nigdy nie pojawia się w odpowiedziach z platformy i jest ignorowana w zapytaniach. Zostanie on całkowicie usunięty w przyszłej wersji.
dataStreamId	string	Niepowtarzalny identyfikator strumienia danych wygenerowanego przez to źródło danych. Identyfikator obejmuje: Producent, model i numer seryjny urządzenia (UID). Nazwa lub nazwa pakietu aplikacji. Nazwa pakietu jest używana, gdy źródło danych zostało utworzone przez aplikację na Androida. Numer projektu dewelopera jest używany, gdy źródło danych zostało utworzone przez klienta typu REST. Typ źródła danych. Nazwa strumienia danych. Pamiętaj, że nie wszystkie atrybuty źródła danych są używane jako część identyfikatora strumienia. Zwłaszcza wersja sprzętu lub aplikacji nie jest używana. Pozwoli nam to zachować ten sam strumień za pomocą aktualizacji wersji. Oznacza to też, że dwa obiekty DataSource mogą przedstawiać 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 to type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName Najmniejszym identyfikatorem rzeczywistego strumienia danych jest: type:dataType.name:developer number number Na koniec numer projektu dewelopera i identyfikator UID urządzenia są zaciemnione w przypadku odczytania go przez klienta REST lub Android, który nie utworzył źródła danych. Numer projektu dewelopera będzie widoczny w czytelnej i normalnej formie tylko dla twórcy źródła danych. Oznacza to, że klient zobaczy inny zestaw danych data_stream_ids niż inny klient z innymi danymi logowania.
dataStreamName	string	Nazwa strumienia jednoznacznie identyfikuje to źródło danych wśród innych źródeł tego samego typu tego samego producenta. Nazwa strumienia jest opcjonalna, ale należy ją wykonać, gdy aplikacja ujawnia 2 strumienia dla tego samego typu danych lub gdy urządzenie ma 2 odpowiednie czujniki.
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.field[].optional	boolean
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.
name	string	Nazwa użytkownika widoczna dla tego źródła danych.
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”

Metody

utwórz

Utworzy nowe źródło danych, które będzie 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.

usuń

Usuwa określone źródło danych. Żądanie nie powiedzie się, jeśli źródło danych zawiera jakiekolwiek punkty danych.

pobierz

Zwraca określone źródło danych.

list

Lista zawiera wszystkie źródła danych, które są widoczne dla dewelopera za pomocą podanych zakresów OAuth. Lista nie jest wyczerpująca. Użytkownik może mieć prywatne źródła danych, które są widoczne tylko dla innych deweloperów, lub wywołania z innymi zakresami.

aktualizacja

Aktualizuje określone źródło danych. Nie można zmieniać właściwości dataStreamId, dataType, type, dataStreamName ani device z wyjątkiem właściwości version.

Źródła danych określa dataStreamId.