Typy danych

Google Fit udostępnia zestaw typów danych o zdrowiu i samopoczuciu w przestrzeni nazw com.google.

Typy danych określają format wartości w punktach danych. Punkt danych może reprezentować:

• Natychmiastowy odczyt lub obserwacja
• Agregacja ze statystykami z danego przedziału czasu

Google Fit definiuje typy danych bieżących obserwacji i typy danych zbiorczych i skalowalnych danych. Punkty danych składają się z wartości pól typu danych i informacji o sygnaturze czasowej. Punkty reprezentujące natychmiastowe obserwacje obejmują sygnaturę czasową oraz punkty typ danych zbiorczych zawiera też czas rozpoczęcia przedziału czasu.

W Google Fit możesz też definiować nowe typy danych.

Grupy typów danych

Google Fit obejmuje te typy danych:

Typy danych publicznych

Standardowe typy danych udostępniane przez platformę mają „com.google” . Na przykład com.google.step_count.delta. Te typy danych rejestrują natychmiastowe odczyty na potrzeby dane o zdrowiu i samopoczuciu, w tym dane o aktywności fizycznej, śnie i odżywianiu. Dowolne może poprosić o odpowiednie uprawnienia do odczytu i zapisu w tych typach danych, z wyjątkiem kilku typów danych o lokalizacji, które mogą odczytać tylko aplikacja, je napisali.

Aby dowiedzieć się więcej, zobacz:

• Typy danych o aktywności
• Typy danych o lokalizacji
• Typy danych dotyczących żywienia

Typy danych dotyczących zdrowia

Typy danych dostarczone przez platformę, które mają ograniczony dostęp ze względu na potencjalnie wrażliwych danych. Więcej informacji znajdziesz w artykule Dane dotyczące zdrowia .

Typy danych zbiorczych

Typy danych do odczytu informacji o zdrowiu i samopoczuciu agregowane według czasu lub typu aktywności. Więcej informacji znajdziesz w artykule Dane zbiorcze .

Prywatne typy danych niestandardowych

Niestandardowe typy danych zdefiniowane przez konkretną aplikację. Tylko aplikacja, która określa może odczytywać i zapisywać dane tego typu. Więcej informacji: Niestandardowe typy danych

Korzystanie z typów danych

val nutritionSource = DataSource.Builder()
    .setDataType(DataType.TYPE_NUTRITION)
    ...
    .build()

val nutrients = mapOf(
    Field.NUTRIENT_TOTAL_FAT to 0.4f,
    Field.NUTRIENT_SODIUM to 1f,
    Field.NUTRIENT_POTASSIUM to 422f
)
val banana = DataPoint.builder(nutritionSource)
    .setTimestamp(now, TimeUnit.MILLISECONDS)
    .setField(Field.FIELD_FOOD_ITEM, "banana")
    .setField(Field.FIELD_MEAL_TYPE, Field.MEAL_TYPE_SNACK)
    .setField(Field.FIELD_NUTRIENTS, nutrients)
    .build()

{
"dataStreamId": "exampleDataSourceId",
...
"dataType": {
  "name": "com.google.step_count.delta"
},
...
}

Zakresy autoryzacji

Zakresy autoryzacji obejmują grupy typów danych, do których użytkownik może autoryzować aplikację dostęp. Pomagają użytkownikom zrozumieć, do jakiego typu danych aplikacja chce mieć dostęp Ułatwiają też przyznawanie aplikacjom uprawnień do korzystania z tych danych, ponieważ aby zatwierdzić każdy typ danych. Użytkownicy przyznają te uprawnienia, gdy: pobrali aplikację.

Po przetestowaniu aplikacji na małej liczbie użytkowników przed jej opublikowaniem musisz poprosić o weryfikację na podstawie odpowiednie zakresy danych. Odczytywanie stron typów danych, do których prowadzą linki powyżej, aby zrozumieć, które zakresy mają zastosowanie do poszczególnych typów danych.

Jeśli na przykład aplikacja musi odczytywać i zapisywać dane ciśnienia, musi zadeklarować, że ma dostęp zarówno do odczytu, jak i zapisu, a także do żądania obu zakresów. Jeśli jest zapisywanie danych o ciśnieniu krwi na platformie Google Fit wymaga jedynie żądania zakresu zapisu.

Odpowiedzialnie wybieraj typy danych. Nie żądaj wszystkich typów danych w przypadku aplikacji może być potrzebna. Określone typy określają, do jakich zakresów jest wyświetlany użytkownik aby przyznać uprawnienia. Pytaj tylko o typy danych, których potrzebuje Twoja aplikacja, aby użytkownicy z większym prawdopodobieństwem przyznania dostępu. Użytkownicy łatwiej potrzebują dostępu do ograniczonych, jasno określonych o opisanych zakresach.

Użyj tej tabeli, aby sprawdzić, czy zakresy, do których aplikacja potrzebuje dostępu, są wrażliwe lub z ograniczeniem (co określa weryfikację ):

Dodawanie nowych zakresów do istniejącej aplikacji

Gdy zaktualizujesz swoją aplikację, aby poprosić o nowy zakres (na przykład po dodaniu nowego zakresu zakresów snu lub tętna albo dodania zakresu odczytu), użytkownicy zobaczą prośbę aplikacja prosi o dostęp do tych zakresów, które mogą przyznać lub odrzuć dostęp.

Sprawdzoną metodą jest wysyłanie do użytkowników próśb o autoryzację zasobów w danym momencie których potrzebujesz. Postępuj zgodnie z wytycznymi dotyczącymi przesyłania prośby o zwiększenie limitu autoryzacji.

Użytkownicy chętniej przyznają dostęp, jeśli będą rozumieć, dlaczego i jak działa Twoja aplikacja używa tych danych:

• Rozważ dodanie ekranu, który będzie ostrzegać lub informować użytkowników, że będą prosić o dostęp dla tych zakresów.
• Wyjaśnij, dlaczego Twoja aplikacja prosi o dostęp do tych zakresów/danych. użytkownicy mogą podjąć świadomą decyzję.

Dowiedz się więcej o sprawdzonych metodach dotyczących uprawnień aplikacji na Androida.