Interfejsy Home API używają protokołu OAuth 2.0 do przyznawania dostępu do urządzeń w strukturze. Protokół OAuth umożliwia użytkownikowi przyznanie uprawnień aplikacji lub usłudze bez konieczności ujawniania danych logowania.
Jeśli masz już zweryfikowanego klienta OAuth (np. z opublikowanej aplikacji), możesz go użyć do testowania interfejsów Home API bez konfigurowania nowego. Więcej informacji znajdziesz w sekcji Jeśli masz już klienta OAuth client.
Podpisywanie aplikacji
Najpierw wygeneruj certyfikat debugowania, uruchamiając aplikację w Android Studio. Gdy uruchamiasz lub debugujesz aplikację w Android Studio, automatycznie generuje ona certyfikat debugowania przeznaczony do programowania i debugowania. Pełne wyjaśnienie znajdziesz w artykule Android Studio: podpisywanie kompilacji debugowania .
Gdy aplikacja jest uruchomiona:
Podłącz urządzenie mobilne do komputera lokalnego. Android Studio wyświetli listę podłączonych urządzeń według numeru modelu. Wybierz urządzenie z listy i kliknij Uruchom projekt. Spowoduje to utworzenie i zainstalowanie aplikacji przykładowej na urządzeniu mobilnym.
Bardziej szczegółowe instrukcje znajdziesz na stronie dla deweloperów aplikacji na Androida w artykule Uruchamianie aplikacji na urządzeniu.
Zatrzymaj uruchomioną aplikację.
Uzyskaj odcisk palca SHA-1 certyfikatu debugowania, postępując zgodnie z instrukcjami podanymi w sekcji Konfigurowanie protokołu OAuth 2.0 / Aplikacje natywne / Android na stronie 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 logowania OAuth.
- Otwórz stronę Interfejsy API i usługi i w menu nawigacyjnym kliknij Dane logowania.
Jeśli nie masz jeszcze skonfigurowanego ekranu zgody dla tego projektu Google Cloud, pojawi się przycisk Skonfiguruj ekran zgody. W takim przypadku skonfiguruj ekran zgody, wykonując te czynności. W przeciwnym razie przejdź do następnej sekcji.
- Kliknij Skonfiguruj ekran zgody. Wyświetli 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. Wyświetli się panel Ekran zgody OAuth.
- Na stronie Informacje o aplikacji wpisz informacje zgodnie z instrukcjami wyświetlanymi na ekranie, a następnie kliknij Zapisz i kontynuuj. Wyświetli się panel Zakresy.
- Nie musisz dodawać żadnych zakresów, więc kliknij Zapisz i kontynuuj. Wyświetli się panel Użytkownicy testowi.
- Kliknij Odbiorcy i przycisk + DODAJ UŻYTKOWNIKÓW.
- Wpisz adres e-mail użytkownika testowego i kliknij przycisk ZAPISZ.
- Kliknij Zapisz i kontynuuj. Wyświetli się panel Podsumowanie.
- Sprawdź informacje na ekranie zgody OAuth, a następnie kliknij Wróć do panelu.
Pełne informacje znajdziesz na stronie pomocy konsoli Google Cloud w sekcji Konfigurowanie ekranu zgody OAuth.
Rejestrowanie aplikacji i tworzenie danych logowania
Aby zarejestrować aplikację w protokole OAuth 2.0 i utworzyć dane logowania OAuth, postępuj zgodnie z instrukcjami podanymi w Konfigurowanie OAuth 2.0. Musisz wskazać typ aplikacji, czyli aplikacja natywna/aplikacja na Androida.
Dodaj odcisk palca SHA-1 uzyskany podczas podpisywania aplikacji do klienta OAuth skonfigurowanego w konsoli Google Cloud, postępując zgodnie z instrukcjami podanymi w Konfigurowanie OAuth 2.0 / Aplikacje natywne na stronie pomocy konsoli Google Cloud.
Gdy urządzenie mobilne jest podłączone do komputera lokalnego, wybierz je z listy i ponownie kliknij Uruchom projekt. Bardziej szczegółowe instrukcje znajdziesz na stronie dla deweloperów aplikacji na Androida w artykule Uruchamianie aplikacji na urządzeniu.
Jeśli masz już klienta OAuth
Jeśli masz już zweryfikowanego klienta OAuth dla opublikowanej aplikacji, możesz go użyć do testowania interfejsów Home API.
Google Home Developer Console do testowania i używania interfejsów Home API nie jest wymagana. Aby jednak opublikować aplikację, nadal musisz mieć zatwierdzoną Developer Console rejestrację, nawet jeśli masz zweryfikowanego klienta OAuth z innej integracji.
Obowiązują te kwestie:
W przypadku korzystania z dotychczasowego klienta OAuth obowiązuje limit 100 użytkowników. Informacje o dodawaniu użytkowników testowych znajdziesz w sekcji Skonfiguruj ekran zgody OAuth screen. Niezależnie od weryfikacji OAuth interfejsy Home API mają limit 100 użytkowników, którzy mogą przyznać uprawnienia Twojej aplikacji. To ograniczenie zostanie zniesione po zakończeniu Developer Console rejestracji.
Developer Console rejestrację należy przesłać do zatwierdzenia, gdy będziesz gotowy(-a) do ograniczenia uprawnień do typu urządzenia za pomocą protokołu OAuth w ramach przygotowań do zaktualizowania aplikacji za pomocą interfejsów Home API.
W przypadku aplikacji Google Cloud, które nadal oczekują na weryfikację OAuth, użytkownicy nie mogą dokończyć procesu OAuth do czasu zakończenia weryfikacji. Próby przyznania uprawnień zakończą się niepowodzeniem z powodu tego błędu:
Access blocked: <Project Name> has not completed the Google verification process.