Interfejsy API Home używają OAuth 2.0 do przyznawania dostępu do urządzeń w ramach danej struktury. Protokół OAuth umożliwia użytkownikowi udzielenie uprawnień aplikacji lub usłudze bez konieczności ujawniania danych logowania.
Jeśli masz już zweryfikowanego klienta OAuth (np. z opublikowanej już aplikacji), możesz go użyć do testowania interfejsów API Home bez konfigurowania nowego. Więcej informacji znajdziesz w artykule Jeśli masz już klienta OAuth.
Podpisywanie aplikacji
Najpierw wygeneruj certyfikat debugowania, uruchamiając aplikację w aplikacji Android Studio. Gdy uruchamiasz aplikację lub debugujesz ją w Android Studio, automatycznie generuje ona certyfikat debugowania przeznaczony do tworzenia i debugowania. Pełne wyjaśnienie znajdziesz w artykule Android Studio: podpisywanie wersji debugowej.
Gdy aplikacja jest uruchomiona:
Połącz urządzenie mobilne z komputerem lokalnym. Android Studio wyświetli listę połączonych urządzeń według numeru modelu. Wybierz urządzenie z listy, a potem kliknij Uruchom projekt. Spowoduje to wygenerowanie i zainstalowanie przykładowej aplikacji na urządzeniu mobilnym.
Więcej szczegółowych instrukcji znajdziesz w artykule Uruchamianie aplikacji na urządzeniu z Androidem na stronie dla deweloperów aplikacji na Androida.
Zatrzymaj uruchomioną aplikację.
Aby uzyskać odcisk cyfrowy SHA-1 certyfikatu debugowania, wykonaj instrukcje podane w artykule Konfigurowanie OAuth 2.0 / Aplikacje natywne / Android w Centrum pomocy Google Cloud Console.
Konfigurowanie ekranu zgody OAuth
- W konsoli Google Cloud otwórz panel wyboru projektu i wybierz projekt, którego chcesz użyć do utworzenia danych uwierzytelniających OAuth.
- Otwórz stronę Interfejsy API i usługi, a potem w menu nawigacyjnym kliknij Dane logowania.
Jeśli nie masz jeszcze skonfigurowanego ekranu zgody w tym projekcie Google Cloud, pojawi się przycisk Skonfiguruj ekran zgody. W takim przypadku skonfiguruj ekran zgody, korzystając z tej procedury. W przeciwnym razie przejdź do następnej sekcji.
- Kliknij Skonfiguruj ekran zgody. Wyświetla się strona Ekran zgody OAuth.
- W zależności od przypadku użycia wybierz Wewnętrzny lub Zewnętrzny, a następnie kliknij Utwórz. Pojawi się panel Ekran zgody OAuth.
- Wpisz informacje na stronie z informacjami o aplikacji zgodnie z instrukcjami wyświetlanymi na ekranie, a potem kliknij Zapisz i kontynuuj. Pojawi się panel Zakresy.
- Nie musisz dodawać żadnych zakresów, więc kliknij Zapisz i kontynuuj. Wyświetli się panel Testowi użytkownicy.
- Jeśli chcesz dodać użytkowników, którzy będą testować dostęp do aplikacji, kliknij Dodaj użytkowników. Pojawi się panel Dodaj użytkowników. Użytkownicy testowi mają uprawnienia do przyznawania uprawnień w aplikacji.
- W pustym polu dodaj co najmniej 1 adres e-mail konta Google, a następnie kliknij Dodaj.
- Kliknij Zapisz i kontynuuj. Pojawi się panel Podsumowanie.
- Zapoznaj się z informacjami na ekranie zgody OAuth, a potem kliknij Wróć do panelu.
Więcej informacji znajdziesz w artykule Konfigurowanie ekranu zgody OAuth w Centrum pomocy konsoli Google Cloud.
Rejestrowanie aplikacji i tworzenie danych logowania
Aby zarejestrować aplikację w usłudze OAuth 2.0 i utworzyć dane logowania OAuth, wykonaj instrukcje podane w artykule Konfigurowanie OAuth 2.0. Musisz wskazać typ aplikacji, czyli natywna/aplikacja na Androida.
Dodaj odcisk cyfrowy SHA-1 uzyskany z podpisywania aplikacji do klienta OAuth skonfigurowanego w konsoli Google Cloud. Aby to zrobić, postępuj zgodnie z instrukcjami w artykule Konfigurowanie OAuth 2.0 / aplikacje natywne w Pomocy konsoli Google Cloud.
Po podłączeniu urządzenia mobilnego do komputera lokalnego wybierz je na liście, a następnie ponownie kliknij Uruchom projekt. Więcej szczegółowych informacji znajdziesz w artykule Uruchamianie aplikacji na urządzeniu z Androidem na stronie dla deweloperów aplikacji na Androida.
Jeśli masz już klienta OAuth
Jeśli masz już zweryfikowanego klienta OAuth dla opublikowanej aplikacji, możesz użyć tego klienta do testowania interfejsów API Home.
Do testowania i używania interfejsów API Home nie jest wymagana rejestracja Google Home Developer Console. Aby opublikować aplikację, musisz jednak mieć zatwierdzoną rejestrację Developer Console, nawet jeśli masz zweryfikowanego klienta OAuth z innej integracji.
Należy wziąć pod uwagę te kwestie:
Jeśli używasz istniejącego klienta OAuth, obowiązuje limit 100 użytkowników. Informacje o dodawaniu użytkowników testowych znajdziesz w artykuleKonfigurowanie ekranu zgody OAuth. Niezależnie od weryfikacji OAuth, interfejsy API Google Home nakładają limit 100 użytkowników, którzy mogą przyznać uprawnienia Twojej aplikacji. Ograniczenie zostanie zniesione po zakończeniu rejestracji w programie Developer Console.
Developer Console rejestracji należy przesłać do zatwierdzenia, gdy będziesz gotowy do ograniczenia uprawnień typu urządzenie za pomocą OAuth w ramach przygotowań do aktualizacji aplikacji za pomocą interfejsów Home API.
W przypadku aplikacji Google Cloud, które czekają na weryfikację OAuth, użytkownicy nie mogą dokończyć procesu OAuth, dopóki nie zostanie ona zakończona. Próby przyznania uprawnień nie powiedzą się i wyświetli się ten komunikat o błędzie:
Access blocked: <Project Name> has not completed the Google verification process.