Lista kontrolna dla deweloperów

Ta lista kontrolna zawiera przegląd kroków zalecanych podczas wdrażania aplikacji z integracją z interfejsem Google Health API.

1. Zanim zaczniesz

Zapoznaj się z dokumentacją dla deweloperów: poznaj typy danych, zakresy i punkty końcowe interfejsu API, aby określić, które z nich są potrzebne do integracji.

Zapoznaj się z zasadami dotyczącymi interfejsu Google Health API: upewnij się, że Twój przypadek użycia jest zgodny z Warunkami korzystania z interfejsu Google Health API dla deweloperów i zasadami Google dotyczącymi interfejsu Health API dla deweloperów i zasadami dotyczącymi danych użytkownika.

Zaplanuj wrażenia użytkownika: jeśli migrujesz użytkowników z interfejsu Fitbit Web API, zapoznaj się z najlepszymi praktykami w przewodniku migracji dotyczącym ponownego uwierzytelniania użytkowników.

2. Konfigurowanie integracji

Skonfiguruj Google Cloud: postępuj zgodnie z instrukcjami w artykule Konfigurowanie Google Cloud i OAuth, aby utworzyć projekt w chmurze Google Cloud, włączyć interfejs Google Health API i skonfigurować dane logowania OAuth 2.0. Używaj osobnych projektów na potrzeby środowiska testowego i produkcyjnego, aby testowanie nie miało wpływu na działającą aplikację.

Skonfiguruj ekran zgody OAuth: w konsoli Google Cloud skonfiguruj ekran zgody OAuth, podając informacje o aplikacji, jej logo i linki do polityki prywatności oraz warunków korzystania z aplikacji.

Dodaj zakresy: w konsoli Google Cloud dodaj zakresy wymagane w przypadku typów danych, do których aplikacja musi mieć dostęp. Sprawdź wdrożenie zakresów, np. czy aplikacja prosi tylko o niezbędne zakresy, czy dostęp do zapisu jest konfigurowany tylko podczas wysyłania danych oraz czy aplikacja prawidłowo obsługuje częściową zgodę użytkownika.

3. Tworzenie i testowanie

Wykonaj pierwsze wywołanie interfejsu API: jeśli dopiero zaczynasz korzystać z interfejsu Google Health API, wykonaj Codelab, aby w ciągu kilku minut wykonać pierwsze wywołanie interfejsu API.

Migracja z interfejsu Fitbit Web API: jeśli migrujesz z interfejsu Fitbit Web API, zapoznaj się z przewodnikiem po migracji i użyj narzędzia do porównywania, aby porównać interfejsy API.

Wdróż OAuth 2.0: wdróż autoryzację OAuth 2.0, aby uzyskać zgodę użytkownika i tokeny interfejsu API. Użyj bibliotek klientów, aby uprościć wdrożenie.

Dodaj użytkowników testowych: gdy aplikacja jest w trybie „Testowanie” w Google Cloud, dodaj użytkowników testowych, aby przetestować integrację z kontami na liście dozwolonych.

Pobieranie danych: użyj odpowiednich punktów końcowych typów danych, aby pobrać dane użytkownika. Postępuj zgodnie ze sprawdzonymi metodami pobierania danych historycznych, oddzielając je od procesu wprowadzania, ponieważ limity szybkości są stałe we wszystkich okresach danych.

Obsługa błędów: zapoznaj się z przewodnikiem rozwiązywania problemów, w którym znajdziesz informacje o typach błędów i sposobach ich obsługi.

Używaj webhooków w przypadku subskrypcji: używaj interfejsu API subskrypcji, aby otrzymywać powiadomienia w czasie rzeczywistym zamiast odpytywania. Umieść powiadomienia przychodzące w kolejce i przetwarzaj je oddzielnie. Zapoznaj się ze sprawdzonymi metodami dotyczącymi webhooków.

4. Przygotowanie do uruchomienia

Weryfikacja OAuth: jeśli aplikacja ma obsługiwać więcej niż 100 użytkowników lub jest gotowa do publicznego udostępnienia, prześlij ją do weryfikacji OAuth. Ten proces może potrwać kilka dni i obejmuje sprawdzenie bezpieczeństwa przez zewnętrzną firmę oraz weryfikację polityki prywatności i warunków korzystania z usługi w aplikacji.

Migracja interfejsu Fitbit Web API: jeśli przeprowadzasz migrację, zadbaj o płynność procesu ponownego uwierzytelniania użytkowników, którzy przechodzą na nową platformę. Postępuj zgodnie z zaleceniami zawartymi w Przewodniku po migracji.

5. Wprowadzenie i obsługa

Opublikuj aplikację: po zakończeniu weryfikacji OAuth opublikuj aplikację w wersji produkcyjnej w konsoli Google Cloud, aby usunąć limit 100 użytkowników.

Monitorowanie: monitoruj wykorzystanie interfejsu API i wskaźniki błędów w konsoli Google Cloud.

Bądź na bieżąco: śledź informacje o wersjach dotyczące aktualizacji i wycofywania interfejsów API.