Interfejsy Home API używają protokołu OAuth 2.0 do przyznawania dostępu do urządzeń w strukturze. OAuth umożliwia użytkownikowi udzielenie uprawnień aplikacji lub usłudze bez konieczności ujawniania swoich danych logowania.
Jeśli masz już zweryfikowanego klienta OAuth (na przykład z już opublikowanej aplikacji), możesz użyć tego klienta do przetestowania interfejsów API Home bez konieczności konfigurowania nowego. Więcej informacji znajdziesz w artykule Jeśli masz już klienta OAuth.
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 tworzenia i debugowania. Pełne wyjaśnienie znajdziesz w artykule Android Studio: Podpisywanie kompilacji debugowej.
Po uruchomieniu aplikacji:
Podłącz urządzenie mobilne do komputera lokalnego. Android Studio wyświetli listę połączonych urządzeń według numeru modelu. Wybierz urządzenie z listy, a następnie kliknij Uruchom projekt. Spowoduje to skompilowanie i zainstalowanie aplikacji przykładowej na urządzeniu mobilnym.
Bardziej szczegółowe instrukcje znajdziesz w artykule Uruchamianie aplikacji na urządzeniu sprzętowym w witrynie dla programistów Androida.
Zatrzymaj działającą aplikację.
Uzyskaj odcisk palca SHA-1 certyfikatu debugowania, postępując zgodnie z instrukcjami podanymi w artykule Konfigurowanie protokołu OAuth 2.0 / aplikacji natywnych / Androida w witrynie pomocy Google Cloud Console.
Skonfiguruj ekran zgody OAuth
- W konsoli Google Cloud przejdź do panelu wyboru projektu i wybierz projekt, którego chcesz użyć do utworzenia poświadczeń OAuth.
- Otwórz stronę Interfejsy API i usługi, a 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 następującej procedury. W przeciwnym wypadku 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 opcję Wewnętrzny lub Zewnętrzny, a następnie kliknij Utwórz. Wyświetli 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.
- Kliknij Odbiorcy, a potem przycisk + DODAJ UŻYTKOWNIKÓW.
- Wpisz adres e-mail użytkownika testowego i kliknij przycisk ZAPISZ.
- Kliknij Zapisz i kontynuuj. Wyświetla się panel Podsumowanie.
- Sprawdź informacje na ekranie zgody OAuth, a potem kliknij Wróć do panelu.
Szczegółowe informacje znajdziesz w artykule Konfigurowanie ekranu zgody OAuth w witrynie pomocy Google Cloud Console.
Rejestrowanie aplikacji i tworzenie danych logowania
Aby zarejestrować aplikację w OAuth 2.0 i utworzyć dane logowania OAuth, postępuj zgodnie z instrukcjami podanymi w artykule Konfigurowanie OAuth 2.0. Musisz wskazać typ aplikacji, czyli aplikacja natywna/na Androida.
Dodaj odcisk cyfrowy SHA-1 uzyskany podczas podpisywania aplikacji do klienta OAuth skonfigurowanego w konsoli Google Cloud, postępując zgodnie z instrukcjami w artykule Konfigurowanie protokołu OAuth 2.0 / aplikacji natywnych na stronie pomocy konsoli Google Cloud.
Gdy urządzenie mobilne będzie połączone z komputerem lokalnym, wybierz je z listy, a następnie ponownie kliknij Uruchom projekt, aby go uruchomić. Bardziej szczegółowe instrukcje znajdziesz w artykule Uruchamianie aplikacji na urządzeniu 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 go użyć do testowania interfejsów Home API.
Google Home Developer Console nie jest wymagana do testowania i korzystania z interfejsów Home API. Aby opublikować aplikację, musisz jednak mieć zatwierdzoną Developer Consolerejestrację, nawet jeśli masz zweryfikowanego klienta OAuth z innej integracji.
Obowiązują te zasady:
Jeśli używasz istniejącego klienta OAuth, obowiązuje limit 100 użytkowników. Informacje o dodawaniu użytkowników testowych znajdziesz w artykuleSkonfiguruj ekran zgody OAuth. Niezależnie od weryfikacji OAuth interfejsy Home API mają limit 100 użytkowników, którzy mogą przyznawać uprawnienia Twojej aplikacji. To ograniczenie zostanie zniesione po zakończeniu rejestracji w usłudze Developer Console.
Developer Console registration należy przesłać do zatwierdzenia, gdy chcesz ograniczyć przyznawanie uprawnień do typów urządzeń za pomocą OAuth w ramach przygotowań do zaktualizowania aplikacji za pomocą interfejsów Home API.
W przypadku Google Cloud aplikacji, które wciąż czekają na weryfikację OAuth, użytkownicy nie mogą zakończyć procesu OAuth, dopóki weryfikacja nie zostanie ukończona. Próby przyznania uprawnień zakończą się niepowodzeniem i wyświetli się ten błąd:
Access blocked: <Project Name> has not completed the Google verification process.