Interfejsy API Home używają protokołu 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 już opublikowanej aplikacji), możesz go użyć do przetestowania interfejsów API Home bez konfigurowania nowego. Więcej informacji znajdziesz w artykule Jeśli masz już klienta OAuth.
Podpisywanie aplikacji
Najpierw wygeneruj klucz OAuth, uruchamiając aplikację w Android Studio. Gdy uruchamiasz aplikację w Android Studio lub debugujesz ją, automatycznie generuje ona klucz OAuth 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.
Szczegółowe instrukcje 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 OAuth, wykonaj instrukcje podane w artykule Konfigurowanie OAuth 2.0 – aplikacje natywnych / Android w Centrum pomocy konsoli Google Cloud.
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 Użytkownicy testowi.
- 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.
Aby testować interfejsy API Home i z nich korzystać, nie musisz rejestrować aplikacji Google Home Developer Console. Aby opublikować aplikację, musisz jednak mieć zatwierdzone konto 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 artykule Konfigurowanie 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 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 powiedzie się i wyświetli się ten komunikat o błędzie:
Access blocked: <Project Name> has not completed the Google verification process.