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 aplikacji lub usłudze uprawnień 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 Home API bez konfigurowania nowego klienta. Więcej informacji znajdziesz w sekcji 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 generowany jest certyfikat debugowania przeznaczony do tworzenia i debugowania. Pełne wyjaśnienie znajdziesz w artykule Android Studio: podpisywanie wersji debugowania.
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 następnie kliknij Uruchom projekt. Spowoduje to skompilowanie i zainstalowanie aplikacji przykładowej na urządzeniu mobilnym.
Szczegółowe instrukcje znajdziesz w artykule Uruchamianie aplikacji na urządzeniu na stronie dla deweloperów aplikacji na Androida.
Zatrzymaj uruchomioną aplikację.
Uzyskaj odcisk SHA-1 certyfikatu debugowania, postępując zgodnie z instrukcjami podanymi w artykule Konfigurowanie 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, w którym chcesz utworzyć dane uwierzytelniające OAuth.
- Otwórz stronę Interfejsy API i usługi i 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, 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 potem 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świetli 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 Centrum pomocy konsoli Google Cloud.
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 podać 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 w Centrum pomocy konsoli Google Cloud.
Gdy urządzenie mobilne jest 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 rejestracja nie jest wymagana do testowania i korzystania z interfejsów Home API. Nadal jednak musisz mieć zatwierdzoną Developer Consolerejestrację, aby opublikować aplikację, nawet jeśli masz zweryfikowanego klienta OAuth z innej integracji.
Pamiętaj o tych kwestiach:
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 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.