Interfejsy Google Fit API, w tym interfejs Google Fit REST API, po 30 czerwca 2025 r. nie będą już dostępne. Od 1 maja 2024 roku deweloperzy nie mogą rejestrować się w celu korzystania z tych interfejsów API.
Instrukcje dotyczące interfejsu API lub platformy, na które należy przejść, znajdziesz w przewodniku po migracji do Health Connect. Porównanie Health Connect z interfejsami API Google Fit i internetowymi interfejsami API Fitbita znajdziesz w porównaniu Health Connect.
Z tego przewodnika dowiesz się, jak zacząć tworzyć aplikacje Google Fit na Androida.
Konfiguracja
Zanim zaczniesz tworzyć aplikację, wykonaj czynności opisane w poniższych 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. Warto utworzyć oddzielne konto, aby przetestować aplikację z perspektywy użytkownika.
Pobierz Usługi Google Play
Pobierz najnowszą bibliotekę kliencką Usług Google Play na stronie dostawcy hostingu:
Do tworzenia aplikacji korzystającej z interfejsu Fitness API zalecamy używanie środowiska programistycznego Android Studio. Szczegółowe informacje o tym, jak utworzyć nowy projekt i skonfigurować go w Android Studio, znajdziesz w sekcji Tworzenie projektu.
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ść:
Dzięki temu Gradle automatycznie pobiera pakiet SDK fitness podczas tworzenia aplikacji.
Tworzenie i testowanie aplikacji
Po zakończeniu czynności konfiguracyjnych możesz zacząć tworzyć swoją aplikację. Na początek dowiedz się, jakie typy danych może zapisywać i odczytywać aplikacja. Dowiedz się więcej o korzystaniu z danych w Google Fit.
Utwórz klienta API i dodaj typy danych, których aplikacja potrzebuje do zapisu lub odczytu danych. Dostępne są te punkty końcowe:
SensorsClient: uzyskiwanie dostępu do różnych źródeł danych o zdrowiu i samopoczuciu z czujników sprzętowych w urządzeniu lokalnym i urządzeniach towarzyszących.
RecordingClient: jeśli zużycie energii jest zawsze włączone, zbieranie danych z czujnika w tle jest włączone.
HistoryClient: wstawianie, usuwanie i odczytywanie danych historycznych w Google Fit.
SessionsClient: tworzenie sesji związanych z 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: korzystaj z niestandardowych typów danych i ustawień na platformie Google Fit.
Poniżej pokazujemy proces autoryzacji, który pojawia się, gdy użytkownik jest proszony o przyznanie uprawnień:
Uprawnienia Androida: przed pobraniem aplikacji użytkownicy mogą sprawdzić, jakich uprawnień Androida żąda Twoja aplikacja. Po pobraniu aplikacja żąda wszelkich wymaganych uprawnień w czasie działania, a użytkownicy je przyznają lub odrzucają.
Sprawdź i połącz: aplikacja sprawdza, czy przyznano uprawnienia, zanim poprosi o dostęp do innych typów danych.
Żądanie zakresów OAuth: Google prosi użytkownika o przyznanie do aplikacji zakresów OAuth niezbędnych dla typów danych, do których chce mieć dostęp.
Dostęp zastosowany: gdy użytkownik przyzna uprawnienia, aplikacja uzyska dostęp do typów danych należących do zakresów, do których użytkownik przyznał uprawnienia.