Informacje o interfejsie Google Health API

Interfejs Fitbit Web API został ulepszony i unowocześniony, aby zapewnić bardziej ustandaryzowaną, spójną i skalowalną podstawę integracji dla deweloperów. Teraz nazywa się Google Health API. Interfejs Google Health API to strategiczna ewolucja starszego interfejsu Fitbit Web API, który został od podstaw przebudowany na nowoczesnej infrastrukturze Google.

Dzięki tej platformie deweloperzy uzyskują dostęp do pełnego potencjału narzędzi Google Cloud dla programistów oraz wygodnego, uproszczonego sposobu zarządzania uprawnieniami użytkowników za pomocą Google OAuth 2.0.

Co zyskujesz dzięki interfejsowi Google Health API?

  • Ujednolicone źródło informacji: nasz nowy „uzgodniony strumień” obsługuje złożone zadanie uzgadniania pokrywających się punktów danych z wielu źródeł. Dzięki temu aplikacje będą wyświetlać te same spójne dane, które użytkownicy widzą w aplikacji Fitbit. Ten strumień będzie udostępniany oprócz naszego strumienia własnego, który zawiera dane z urządzeń Fitbit i Pixel, a także wpisy ręczne.
  • Modernizacja techniczna i wydajność: skonsolidowaliśmy ponad 100 starszych punktów końcowych w uproszczony zestaw pakietów typów danych i wyeliminowaliśmy niespójności w formatach danych, strefach czasowych, jednostkach miary i obsłudze błędów. Ponadto obsługujemy teraz protokół HTTP/REST, który umożliwia wydajne pobieranie danych. Dodatkowo dane z bieżącego dnia i webhooki są teraz dostępne dla wszystkich odpowiednich typów danych za pomocą specjalnego punktu końcowego listy.
  • Ulepszone webhooki i skalowalność: korzystaj z rozszerzonej obsługi webhooków, w tym automatycznych subskrypcji i szczegółowego zarządzania wszystkimi odpowiednimi typami danych, zaprojektowanych z myślą o skalowaniu z następną generacją aplikacji związanych ze zdrowiem opartych na AI.
  • Uproszczona tożsamość i bezpieczeństwo: zastąp starszą autoryzację Fitbita (FOT) protokołem Google OAuth 2.0. Dzięki temu deweloperzy mogą korzystać ze standardowych bibliotek uwierzytelniania Google, co upraszcza bazy kodu, a użytkownikom zapewnia znajomy, scentralizowany sposób zarządzania uprawnieniami. Wszystkie zakresy interfejsu API Google Health są sklasyfikowane jako ograniczone, co wymaga sprawdzenia prywatności i bezpieczeństwa w celu uzyskania dostępu.

Podoba Ci się to, co widzisz? Wypróbuj teraz

Wersje interfejsu API i kanał publicznej wersji beta

Interfejs Google Health API korzysta z wersjonowania opartego na kanałach zgodnie z propozycjami ulepszeń interfejsu API (AIP) Google, a konkretnie z AIP-185: wersjonowanie interfejsu API i AIP-181: poziomy stabilności. Interfejs API jest dostępny w 2 kanałach publicznych: stabilnym v4 i publicznej wersji beta v4beta. Google obsługuje oba kanały za pomocą standardowych sposobów kontaktu z zespołem pomocy.

Porównanie wersji stabilnej i beta

Zgodnie z AIP-185 kanał v4beta działa jako nadzbiór stabilnego kanału v4. Obejmuje wszystkie stabilne funkcje v4 oraz typy danych, pola i metody z wcześniejszym dostępem, które są testowane przez partnerów.

W dokumentacji elementy interfejsu API, które są dostępne tylko w wersji beta, są oznaczone etykietą v4beta.

Funkcja Kanał stabilny (v4) Publiczna wersja beta (v4beta)
Podstawowy identyfikator URI REST https://health.googleapis.com/v4 https://health.googleapis.com/v4beta
Pakiet gRPC google.devicesandservices.health.v4 google.devicesandservices.health.v4beta
Dokumentacja referencyjna v4 REST i v4 RPC v4beta REST i v4beta RPC
Poziom stabilności Gotowe do wykorzystania w środowisku produkcyjnym i podlegające regułom zgodności wstecznej AIP-180. Niestabilna wersja testowa, która może zostać w każdej chwili zmieniona lub usunięta bez powiadomienia.
Zamierzone użycie aktywne aplikacje produkcyjne dla użytkowników; Wczesne testowanie, prototypowanie, weryfikacja schematu i opinie deweloperów.
Pomoc Pomoc jest dostępna za pośrednictwem standardowych sposobów kontaktu z zespołem pomocy. Pomoc jest dostępna przez standardowe sposoby kontaktu z zespołem pomocy w zakresie zgłaszania błędów, rozwiązywania problemów i przesyłania opinii na temat projektu.

Jak traktować kanał v4beta

Podczas korzystania z funkcji oznaczonych tagiem v4beta postępuj zgodnie z tymi wytycznymi:

  • Używaj v4beta głównie w środowiskach programistycznych, przejściowych i nieprodukcyjnych środowiskach testowych. Nie zalecamy udostępniania funkcji produkcyjnych, które zależą od punktów końcowych v4beta lub typów danych dostępnych tylko w wersji beta.
  • Schematy, nazwy pól, zachowania punktów końcowych i reprezentacje danych w v4beta mogą ulec zmianie bez ostrzeżenia. Funkcje i typy danych w wersji beta mogą też zostać całkowicie usunięte, jeśli nie spełniają celów weryfikacji.
  • Odizoluj eksperymentalny kod klienta v4beta za pomocą flag funkcji lub osobnych modułów, aby zmiany powodujące niezgodność w kanale wersji beta nie zakłócały podstawowej integracji z v4.
  • Uzyskaj pomoc, zgłaszaj problemy i dziel się opiniami na temat implementacji v4beta przez nasze standardowe sposoby kontaktu z zespołem pomocy, aby pomóc w kształtowaniu ostatecznego projektu interfejsu API.

Przejście z wersji v4beta do stabilnej wersji v4

Nowe typy danych i funkcje są wprowadzane w v4beta, aby umożliwić partnerom testowanie i weryfikację rynkową przed przejściem do kanału stabilnego v4.

Google ocenia funkcje beta pod kątem tych kryteriów, zanim zostaną one przeniesione do v4:

  • Testy partnerów potwierdzają, że model danych, semantyka pól i wzorce zapytań spełniają wymagania rzeczywistych aplikacji.
  • Opinie deweloperów i oceny projektu zostały zebrane, a schemat jest gotowy do zablokowania zgodnie z gwarancjami zgodności wstecznej AIP-180.
  • Kompleksowe potoki danych, synchronizacja urządzeń i niezawodność usług spełniają standardy jakości produkcji.
  • Zgodnie z zasadami wycofywania AIP-185 wszystkie pola i zachowania wycofane podczas testów beta są usuwane, a nie promowane do wersji v4.

Chociaż AIP-181 podaje ogólną zasadę, że ocena wersji beta trwa około 90 dni, rzeczywisty czas przejścia funkcji z wersji v4beta do wersji v4 zależy od jej złożoności, dostępności sprzętu i opinii dotyczących weryfikacji. Niektóre funkcje mogą zostać udostępnione wcześniej, a inne mogą pozostać w v4beta dłużej lub zostać wycofane.

Gdy typ danych lub funkcja zostaną przeniesione do kanału stabilnego v4, Google ogłasza to w informacjach o wersji. Wtedy, zanim udostępnisz integrację użytkownikom wersji produkcyjnej, zmień żądania z https://health.googleapis.com/v4beta na https://health.googleapis.com/v4.

Co z Fitbit Web API?

Starsza wersja interfejsu Fitbit Web API została wyłączona zgodnie z tym harmonogramem:

  • 30 września 2026 r. (zakończenie wsparcia): zakończyliśmy obsługę interfejsu Fitbit Web API i przestaliśmy naprawiać błędy oraz zapewniać pomoc dotyczącą interfejsu API.
  • 2 listopada 2026 r. (wyłączenie interfejsu API): interfejs Fitbit Web API i punkty końcowe Fitbit OAuth zostały wyłączone i nie działają już ani nie synchronizują danych z użytkownikami Google Health. Żądania wysyłane do tych punktów końcowych nie powiodą się i zwrócą kod stanu HTTP 410 Gone.

Deweloperzy korzystający ze starszej wersji interfejsu Fitbit Web API i autoryzacji Fitbit powinni przenieść swoje aplikacje i użytkowników do interfejsu Google Health API i Google OAuth 2.0.

Aby rozpocząć, zapoznaj się z przewodnikiem po migracji.

Na jakich urządzeniach to działa?

Wszystkie urządzenia Fitbit i zegarki Google Pixel Watch, zarówno obecne, jak i poprzednie, będą zbierać dane, które są zwracane przez interfejs Google Health API. Rodzaj dostępnych danych zależy od funkcji obsługiwanych przez urządzenia.

Listę aktualnych urządzeń znajdziesz w Google Store.

Jak mogę przesłać opinię?

Twoja opinia jest dla nas bardzo ważna. Zachęcamy do dzielenia się opiniami za pomocą naszych sposobów kontaktu z zespołem pomocy, które są wymienione na stronie Pomoc.

Dołożyliśmy wszelkich starań, aby te interfejsy API były jak najbardziej pomocne, ale interfejs Google Health API stale się rozwija. Pamiętaj, że na podstawie Twoich opinii możemy wprowadzić zmiany do końca maja, które będą wymagały odpowiednich aktualizacji po Twojej stronie.

Plan działań

Oto lista funkcji, które pojawią się w 2026 r.

IV kwartał 2026 r.

Typy danych (odczyt i zapis)

  • Szczegółowe dane o temperaturze skóry
  • Podstawowa przemiana materii
  • Będziemy dodawać typy danych, aby osiągnąć zgodność z Health Connect. W IV kwartale 2026 r. i I kwartale 2027 r. dodamy wiele innych typów danych Health Connect.

Funkcje

  • Publiczny kanał beta umożliwiający wcześniejszy dostęp do nowych typów danych
  • Punkt końcowy statystyk do monitorowania telemetrii webhooków