Lista kontrolna dla deweloperów

Ta lista kontrolna zawiera omówienie kroków zalecanych do uruchomienia aplikacji z integracją interfejsu Google Health API.

1. Zanim zaczniesz

Zapoznaj się z dokumentacją dla programistów: dowiedz się więcej o typach danych, zakresach i punktach końcowych interfejsu API, aby określić, które z nich są potrzebne do integracji.

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

Zaplanuj wygodę użytkowników: jeśli migrujesz użytkowników z Fitbit Web API, zapoznaj się ze sprawdzonymi metodami opisanymi w przewodniku migracji, które pomogą Ci w ponownym uwierzytelnianiu użytkowników.

2. Skonfiguruj integrację

Skonfiguruj Google Cloud: postępuj zgodnie z instrukcjami w sekcji 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.

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

Dodaj zakresy: w konsoli Google Cloud dodaj zakresy wymagane w przypadku typów danych, do których Twoja aplikacja musi mieć dostęp. Sprawdź implementację zakresu, np. czy aplikacja prosi tylko o potrzebne zakresy, czy dostęp do zapisu jest konfigurowany tylko podczas wysyłania danych oraz czy częściowa zgoda jest obsługiwana w odpowiedni sposób.

3. Programowanie 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.

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

Zaimplementuj protokół OAuth 2.0: zaimplementuj autoryzację OAuth 2.0, aby uzyskać zgodę użytkownika i tokeny interfejsu API. Aby uprościć implementację, użyj bibliotek klienta.

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.

Pobierz dane: użyj odpowiednich punktów końcowych typu danych do pobrania danych użytkownika. Postępuj zgodnie ze sprawdzonymi metodami pobierania danych historycznych, oddzielając je od procesu wdrażania, ponieważ limity zapytań są stałe we wszystkich okresach danych.

Obsługuj błędy: zapoznaj się z przewodnikiem rozwiązywania problemów , aby dowiedzieć się, jak radzić sobie z typowymi błędami.

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

4. Przygotowanie do uruchomienia

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

Migracja z Fitbit Web API: jeśli przeprowadzasz migrację, upewnij się, że proces ponownego uwierzytelniania użytkowników jest płynny. Postępuj zgodnie z zaleceniami w przewodniku migracji.

5. Uruchomienie i utrzymanie

Opublikuj aplikację: gdy weryfikacja OAuth zostanie zakończona, opublikuj aplikację w wersji „Produkcyjna” w konsoli Google Cloud, aby usunąć limit 100 użytkowników.

Monitoruj: monitoruj wykorzystanie interfejsu API i współczynniki błędów w konsoli Google Cloud.

Bądź na bieżąco: śledź informacje o aktualizacjach i wycofywaniu interfejsu API w informacjach o wersji.