Interfejsy Google Fit API, w tym interfejs Google Fit REST API, nie będą już dostępne po 2026 roku. Od 1 maja 2024 r. deweloperzy nie mogą rejestrować się w celu korzystania z tych interfejsów API.

Instrukcje dotyczące migracji do danego interfejsu API lub platformy znajdziesz w przewodniku Health Connect po migracji. Porównanie Health Connect z interfejsami Google Fit API i Fitbit Web API znajdziesz w przewodniku porównawczym Health Connect.

Dowiedz się więcej o Health Connect i o tym, jak zintegrować się z interfejsem API.

Ta strona została przetłumaczona przez Cloud Translation API.

Pierwsze kroki na Androidzie
Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Z tego przewodnika dowiesz się, jak rozpocząć tworzenie aplikacji na Google Fit na Androida.

Konfiguracja

Zanim zaczniesz tworzyć aplikację, wykonaj czynności opisane w tych sekcjach.

Załóż konto Google

Aby korzystać z interfejsów API Google Fit, musisz mieć konto Google. Możesz utworzyć nowe konto lub użyć istniejącego. 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 hostowanym środowisku deweloperskim:

Otwórz Menedżera pakietu Android SDK.
W sekcji Narzędzia SDK znajdź Usługi Google Play.
Jeśli stan tych pakietów nie jest Zainstalowany, zaznacz oba i kliknij Zainstaluj pakiety.

Pobieranie identyfikatora klienta OAuth 2.0

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

Tworzenie i konfigurowanie projektu

Zalecamy użycie środowiska programistycznego Android Studio do tworzenia aplikacji z Fitness API. Szczegółowe informacje o tworzeniu nowego projektu i jego konfigurowaniu w Android Studio znajdziesz w artykule Tworzenie projektu.

Dodawanie biblioteki klienta Usług Google Play

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

Kotlin DSL

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

...

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

Groovy DSL

apply plugin: 'com.android.application'

...

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

Dzięki temu Gradle automatycznie pobiera pakiet SDK Fitness podczas kompilowania aplikacji.

Tworzenie i testowanie aplikacji

Po zakończeniu konfiguracji możesz zacząć tworzyć aplikację. Aby zacząć, dowiedz się, jakie typy danych może ona przechowywać i czytać. Dowiedz się więcej o pracy z danymi w Google Fit.

Uzyskaj wymagane uprawnienia na Androidzie

Aby odczytywać i zapisywać niektóre typy danych, aplikacja musi prosić o uprawnienia Androida.

Przyznawanie uprawnień OAuth

Typy danych, do których aplikacja ma uprawnienia dostępu, odpowiadają zakresowi autoryzacji. Aby poprosić o te uprawnienia, musisz dodać typy danych, do których aplikacja potrzebuje dostępu, w FitnessOptionsinstansji. Gdy aplikacja prosi o możliwość korzystania z jakiegokolwiek typu danych Google Fit, pakiet SDK Androida automatycznie sprawdza, do których 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 dobrze zorganizowanym życiu pochodzących z czujników sprzętowych na urządzeniu lokalnym i na urządzeniach towarzyszących.
RecordingClient: zbieranie danych z czujników w tle przy niskim poborze mocy.
HistoryClient: w Google Fit możesz wstawiać, usuwać i czytać dane historyczne.
SessionsClient: tworzenie sesji aktywności użytkowników i zarządzanie nimi.
GoalsClient: odczytywanie celów związanych z punktami i krokami utworzonych przez użytkowników w Google Fit.
ConfigClient: dostęp do niestandardowych typów danych i ustawień na platformie Google Fit.

Przykład tworzenia klienta Fitness API

Wynikający z tego proces autoryzacji użytkownika

Poniżej przedstawiono proces autoryzacji, który użytkownicy przechodzą, gdy proszą o przyznanie uprawnień:

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

Uprawnienia na Androidzie: użytkownicy widzą, jakie uprawnienia na Androidzie żądała Twoja aplikacja przed pobraniem. Po pobraniu aplikacja prosi o uprawnienia, których potrzebuje w czasie działania, a użytkownicy udzielają lub odmawiają tych uprawnień.
Sprawdzanie i łączenie: aplikacja sprawdza, czy zostały przyznane uprawnienia, zanim poprosi o dostęp do innych typów danych.
Prośba o zakresy OAuth: Google prosi użytkownika o przyznanie Twojej aplikacji zakresów OAuth potrzebnych do obsługi typów danych, do których aplikacja ma uzyskiwać dostęp.
Zastosowane uprawnienia: gdy użytkownik przyzna uprawnienia, aplikacja może uzyskać dostęp do typów danych należących do zakresów, do których użytkownik przyznał uprawnienia.

Przesyłanie wniosku o weryfikację

Po utworzeniu i przetestowaniu aplikacji musisz przesłać prośbę o weryfikację z różnymi poziomami uzasadnienia wymaganymi w przypadku zakresów wrażliwych i zakresów z ograniczeniami.