Interfejsy Google Fit API, w tym interfejs Google Fit REST API, zostaną wycofane w 2026 roku. Od 1 maja 2024 roku deweloperzy nie mogą rejestrować się, aby korzystać z tych interfejsów API.

W przypadku integracji działających w chmurze zalecamy migrację do interfejsu Google Health API, a w przypadku śledzenia kroków i aplikacji na Androida przeznaczonych głównie na urządzenia mobilne – do Health Connect. Instrukcje dotyczące tego, na który interfejs API lub platformę przejść, znajdziesz w przewodniku po migracji do Fit.

Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Pierwsze kroki na Androidzie

Z tego przewodnika dowiesz się, jak zacząć tworzyć aplikacje na Androida z użyciem Google Fit.

Konfiguracja

Zanim zaczniesz tworzyć aplikację, wykonaj czynności opisane w poniższych sekcjach.

Uzyskaj konto Google

Aby korzystać z interfejsów API Google Fit, musisz mieć konto Google. Możesz utworzyć nowe konto lub użyć dotychczasowego. Możesz utworzyć osobne konto, aby przetestować aplikację z perspektywy użytkownika.

Pobierz Usługi Google Play

Pobierz najnowszą bibliotekę klienta usług Google Play na hoście programistycznym:

Otwórz Menedżera pakietu Android SDK.
W sekcji SDK Tools znajdź Usługi Google Play.
Jeśli stan tych pakietów nie jest określony jako Zainstalowano, wybierz oba pakiety i kliknij Zainstaluj pakiety.

Uzyskiwanie identyfikatora klienta OAuth 2.0

Aby włączyć Fitness API, uzyskaj identyfikator klienta OAuth 2.0.

Tworzenie i konfigurowanie projektu

Do tworzenia aplikacji z interfejsem Fitness API zalecamy używanie środowiska programistycznego Android Studio. Szczegółowe informacje o tworzeniu nowego projektu i konfigurowaniu go w Android Studio znajdziesz w artykule na temat tworzenia projektów.

Dodawanie biblioteki klienta Usług Google Play

W Android Studio otwórz plik build.gradle modułu i dodaj bibliotekę klienta usług Google Play jako zależność:

Kotlin DSL

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.3.0")
        implementation("com.google.android.gms:play-services-auth:22.0.0")
}

Groovy DSL

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.3.0'
    implementation 'com.google.android.gms:play-services-auth:22.0.0'
}

Dzięki temu Gradle automatycznie pobierze pakiet SDK do fitnessu podczas kompilowania aplikacji.

Tworzenie i testowanie aplikacji

Po wykonaniu czynności konfiguracyjnych możesz zacząć tworzyć aplikację. Na początek dowiedz się, jakie typy danych aplikacja może przechowywać i odczytywać. Dowiedz się więcej o pracy z danymi w Google Fit.

Uzyskiwanie niezbędnych uprawnień na Androidzie

Aby odczytywać i zapisywać niektóre typy danych, aplikacja musi poprosić o uprawnienia na Androidzie.

Uzyskiwanie uprawnień OAuth

Typy danych, do których aplikacja ma uprawnienia dostępu, odpowiadają zakresom autoryzacji. Aby poprosić o te uprawnienia, musisz dodać typy danych, do których aplikacja potrzebuje dostępu, w instancji FitnessOptions. Gdy aplikacja prosi o użycie dowolnego typu danych Google Fit, pakiet Android SDK automatycznie sprawdza, do jakich zakresów należą te dane, i prosi użytkownika o autoryzację tych zakresów.

Tworzenie klienta API

Utwórz klienta interfejsu API i dodaj typy danych, do których aplikacja musi mieć dostęp, aby zapisywać lub odczytywać dane. Dostępne są te punkty końcowe:

SensorsClient: dostęp do różnych źródeł danych o zdrowiu i samopoczuciu z czujników sprzętowych na urządzeniu lokalnym i urządzeniach towarzyszących.
RecordingClient: do zbierania danych z czujników w tle przy niskim zużyciu energii i stale włączonym urządzeniu.
HistoryClient: wstawianie, usuwanie i odczytywanie danych historycznych w Google Fit.
SessionsClient: tworzenie sesji aktywności użytkownika i zarządzanie nimi.
GoalsClient: odczytywanie celów dotyczących punktów kardio i kroków utworzonych przez użytkowników w Google Fit.
ConfigClient: dostęp do niestandardowych typów danych i ustawień na platformie Google Fit.

Zobacz przykład tworzenia klienta Fitness API

Wynikowy proces autoryzacji użytkownika

Poniżej przedstawiamy proces autoryzacji, który użytkownicy widzą, gdy są proszeni o przyznanie uprawnień:

**Rysunek 1.** Proces autoryzacji użytkowników.

Uprawnienia Androida: użytkownicy widzą, o jakie uprawnienia Androida prosi aplikacja, zanim ją pobiorą. Po pobraniu aplikacja prosi o uprawnienia w czasie działania, których potrzebuje, a użytkownicy mogą je przyznać lub odrzucić.
Sprawdzanie aplikacji i łączenie: aplikacja sprawdza, czy uprawnienia zostały przyznane, zanim poprosi o dostęp do innych typów danych.
Prośba o zakresy OAuth: Google prosi użytkownika o przyznanie aplikacji zakresów OAuth wymaganych w przypadku typów danych, do których aplikacja chce uzyskać dostęp.
Dostęp przyznany: gdy użytkownik przyzna uprawnienia, aplikacja może uzyskać dostęp do typów danych, które należą do zakresów, do których użytkownik przyznał uprawnienia.

Składanie wniosku o weryfikację

Po utworzeniu i przetestowaniu aplikacji musisz poprosić o jej weryfikację, podając różne poziomy uzasadnienia dla zakresów wrażliwych i z ograniczeniami.