Interfejsy Google Fit API są wycofywane i zostaną wyłączone pod koniec 2026 roku. Google oferuje kilka produktów i usług związanych ze zdrowiem i dobrym samopoczuciem, które pomogą użytkownikom w osiąganiu celów po wycofaniu interfejsów.
Ostrzeżenie: interfejs Google Fit API (w tym REST API) będzie obsługiwany tylko do końca 2026 roku. W przypadku integracji opartych na chmurze zalecamy przejście na interfejs Google Health API, a w przypadku śledzenia kroków i aplikacji mobilnych – na Health Connect.
Poniższe wytyczne pokazują, do której usługi należy przeprowadzić migrację w zależności od sposobu korzystania z interfejsów Google Fit API.
Zalecane ścieżki migracji
Wybór interfejsu API powinien zależeć od typu aplikacji i konkretnych potrzeb w zakresie danych.
Według typu aplikacji
| Typ aplikacji | Zalecana ścieżka | Główny powód |
|---|---|---|
| Aplikacja do śledzenia kroków | Health Connect | Odczytywanie na urządzeniu mobilnym zagregowanych danych o liczbie kroków z różnych źródeł. |
| Aplikacja towarzysząca do monitorowania aktywności | Google Health API | Platforma internetowa wymagająca protokołu OAuth do integracji z użytkownikami. |
| Platforma Zdrowie i fitness | Interfejs API Google Health i Health Connect | Używaj interfejsu Google Health API do danych z urządzeń Fitbit i Google oraz Health Connect do zagregowanych danych na urządzeniu. |
Obecna integracja
| Bieżąca integracja | Zalecana ścieżka | Dostępność |
|---|---|---|
| Google Fit (Android i interfejs API REST) | Google Health API | Dostępna |
| Odczytywanie kroków na urządzeniu mobilnym (za pomocą interfejsu Google Fit Recording API) | Health Connect | Dostępna |
| Interfejs API Fit na Wear OS | Funkcje dotyczące zdrowia | Dostępna |
| Fitbit Web API | Google Health API | Dostępna |
| Interfejs API nagrywania na urządzeniach mobilnych | Health Connect | Dostępna |
| Health Connect | Zachowaj dotychczasową integrację lub dodaj interfejs Google Health API | Dostępna |
Porównania techniczne
W sekcjach poniżej znajdziesz porównanie techniczne interfejsów Google Fit API, Google Health API i Health Connect, które pomoże Ci wybrać odpowiednią ścieżkę migracji.
Różnice między interfejsem Fit API a interfejsem Google Health API
Skorzystaj z tej ścieżki, jeśli Twoja aplikacja jest platformą internetową lub wymaga interakcji serwer-serwer (S2S).
| Funkcja | Interfejs API Fit (Android/REST) | Google Health API |
|---|---|---|
| Konfiguracja projektu | Google Cloud Console | Tworzenie projektu w chmurze Google |
| Konfiguracja protokołu OAuth | Typ aplikacji na Androida lub aplikacji internetowej | Typ aplikacji internetowej |
| Architektura danych | Typy z prefiksami: com.google |
Ujednolicone typy danych interfejsu Google Health API |
| Rejestracja aplikacji | Tworzenie projektu w chmurze Google | Tworzenie projektu w chmurze Google Cloud i włączanie interfejsu Google Health API |
Interfejs API Fit a Health Connect
Użyj tej ścieżki w przypadku aplikacji na Androida, które są zoptymalizowane pod kątem urządzeń mobilnych i odczytują dane z lokalnego urządzenia.
| Funkcja | Interfejs API Fit na Androida | Health Connect |
|---|---|---|
| Rejestracja | Google Cloud Console | Projekt w Sklepie Play i deklaracja dotycząca aplikacji związanych ze zdrowiem |
| Uwierzytelnianie | Wymagany protokół OAuth 2.0 | Nie wymaga OAuth (uprawnienia na urządzeniu) |
| Przechowywanie danych | Ukierunkowane na chmurę | Zależne od urządzenia (na urządzeniu) |
| Odbiorcy | Deweloperzy starszych wersji Androida | Deweloperzy Modern Android |
| Uprawnienia | Zakresy protokołu OAuth | Uprawnienia w pliku manifestu Androida |
Integracje z interfejsem Fit API
W kolejnych sekcjach znajdziesz wskazówki dotyczące migracji z poszczególnych interfejsów Google Fit API. Jeśli integracja obejmuje też elementy interfejsu, które łączą się z aplikacją Google Fit, dodatkowe wskazówki znajdziesz w wytycznych dotyczących integracji z aplikacją Fit.
Aplikacje korzystające z interfejsu Fit Recording API do rejestrowania kroków
Interfejs Fit Recording API umożliwia aplikacji żądanie automatycznego przechowywania danych z czujników w sposób oszczędzający baterię przez tworzenie subskrypcji.
Każda subskrypcja łączy aplikację na Androida z określonym typem danych o aktywności fizycznej lub źródłem danych, a typ danych Step jest powszechnie używany do rejestrowania kroków.
Aby przeprowadzić migrację z interfejsu Fit Recording API, wykonaj te czynności:
| Telefon | Wear |
|
Skorzystaj z funkcji dotyczących zdrowia:
Więcej informacji o różnicach między nimi znajdziesz w dokumentacji funkcji dotyczących zdrowia. |
Aplikacje korzystające z interfejsu History API do odczytywania lub zapisywania danych w magazynie informacji o aktywności fizycznej
History API umożliwia aplikacji wykonywanie operacji zbiorczych w magazynie informacji o aktywności fizycznej. Te operacje obejmują odczytywanie, wstawianie, aktualizowanie i usuwanie historycznych danych o zdrowiu i samopoczuciu.
Aby przeprowadzić migrację z interfejsu History API, wykonaj te czynności:
| Telefon | Wear |
|
Nie dotyczy. Używaj Health Connect w aplikacji mobilnej, a nie na urządzeniu do noszenia. |
Aplikacje korzystające z interfejsu Sensor API do wyświetlania danych o aktywności fizycznej w czasie rzeczywistym
Interfejs Sensor API umożliwia odczytywanie w aplikacji nieprzetworzonych danych z czujników w czasie rzeczywistym. Interfejs Sensor API wykonuje te czynności:
- Przechowuje listę źródeł danych dostępnych na urządzeniu i urządzeniach towarzyszących.
- Rejestruje detektory, które mają otrzymywać nieprzetworzone dane z czujników.
- Anuluje rejestrację detektorów, które mają już nie otrzymywać nieprzetworzonych danych z czujników.
Aby przeprowadzić migrację z interfejsu Sensor API, wykonaj te czynności:
| Telefon | Wear |
|
Użyj interfejsów API Sensors, Fused Location Provider. |
Skorzystaj z funkcji dotyczących zdrowia na Wear OS:
|
Aplikacje korzystające z interfejsu Session API do podsumowywania aktywności
Sesje to przedziały czasu, w których użytkownicy wykonują aktywność związaną z fitnessem.
Session API umożliwia aplikacji tworzenie sesji w magazynie informacji o aktywności fizycznej.
Aby przeprowadzić migrację z interfejsu Session API, wykonaj te czynności:
| Telefon | Wear |
|
Start/stop: nie dotyczy. Aplikacja powinna wewnętrznie śledzić stan trwających sesji. Odczyt i zapis:przejście na interfejs Google Health API. |
Start/stop: użyj funkcji dotyczących zdrowia (ExerciseClient). Odczyt/zapis: użyj Health Connect w aplikacji mobilnej. W przypadku konkretnych przepływów pracy zalecamy te działania:
|
Aplikacje korzystające z interfejsu Goals API
Cele to wartości docelowe w aplikacji Google Fit, które użytkownicy mogą ustawiać dla swoich danych, takich jak liczba kroków i punkty kardio. Platforma Fit rejestruje ich cele i śledzi ich codzienną aktywność w odniesieniu do tych celów za pomocą interfejsu Goals API.
| Telefon | Wear |
| Brak zastępczego interfejsu API. | Brak zastępczego interfejsu API. |
Aplikacje korzystające z interfejsu BLE API
Aplikacja może znajdować dostępne urządzenia Bluetooth Low Energy (BLE) i wstawiać dane z czujników na platformę Google Fit za pomocą interfejsu BLE API.
Aby przeprowadzić migrację z interfejsu BLE API, wykonaj te czynności:
| Telefon | Wear |
| Skorzystaj bezpośrednio z interfejsów Bluetooth API na Androidzie. | Skorzystaj bezpośrednio z interfejsów Bluetooth API na Androidzie. |
Wycofane funkcje
Te funkcje nie mają bezpośredniego odpowiednika w interfejsie API. Używaj zalecanych standardowych interfejsów API Androida:
- Sensor API: użyj platformy Android Sensors lub interfejsu Fused Location Provider API, aby uzyskać surowe dane w czasie rzeczywistym.
- Goals API: brak zastępczego interfejsu API. Zarządzaj śledzeniem celów i dziennymi celami aktywności w logice aplikacji.
- Interfejs Bluetooth Low Energy (BLE) API: używaj bezpośrednio interfejsów Bluetooth API na Androidzie do komunikacji ze sprzętem.
Integracje aplikacji Fit
Jeśli Twoja aplikacja łączy się z Google Fit w celu udostępniania danych, postępuj zgodnie z instrukcjami dotyczącymi przenoszenia obecnych i nowych użytkowników do Health Connect lub interfejsu Google Health API w tych sekcjach:
Obecni użytkownicy Twojej aplikacji
Jeśli interfejs Twojej aplikacji umożliwia użytkownikom łączenie się z Google Fit (lub jeśli Twoja aplikacja znajduje się na liście aplikacji współpracujących z Google Fit), możesz nadal utrzymywać integrację aplikacji z Google Fit dla obecnych użytkowników.
Będziemy aktualizować tę sekcję, aby poinformować Cię o tym, kiedy należy wycofać integrację aplikacji Fit i jakie są najlepsze opcje utrzymania komfortu użytkowników. W międzyczasie możesz skontaktować się z nami.
| ikona potwierdzeniaZrób to | ikona zakazuNie rób tego |
| Zaoferuj Health Connect lub interfejs Google Health API jako nową opcję w swojej aplikacji.
Skup się na korzyściach dla użytkowników, takich jak bogatsze dane i statystyki, prywatność i bezpieczeństwo.
|
Poproś użytkowników o odłączenie się od Google Fit.
|
Nowi użytkownicy aplikacji
Aby zapewnić podobne wrażenia nowym użytkownikom aplikacji, zalecamy utworzenie integracji z Health Connect lub interfejsem Google Health API.
Health Connect zapewnia dostęp do nowych źródeł i typów danych, aby zapewnić użytkownikom większe możliwości, a dane są bezpiecznie przechowywane na urządzeniu. Interfejs Google Health API to platforma internetowa do obsługi danych z Fitbita i urządzeń Google.
| ikona potwierdzeniaZrób to | ikona zakazuNie rób tego |
| Uwzględnij Health Connect lub interfejs Google Health API w procesie konfiguracji aplikacji. | Udostępnij Fit jako aplikację, którą użytkownicy mogą połączyć po udostępnieniu Health Connect. |