Odwrócenie aplikacji

Po wdrożeniu protokołu OAuth 2.0 możesz opcjonalnie skonfigurować Oparta na uwierzytelnianiu App Flip, która pozwala użytkownikom szybciej połączyć swoje konta w Twoim systemie uwierzytelniania z kontami Google. w poniższych sekcjach opisano, jak projektować i wdrażać App Flip za Twoją akcję smart home.

Wskazówki dotyczące wyglądu

W tej sekcji opisano wymagania i zalecenia dotyczące projektu ekranu zgody na łączenie kont w Flip. Gdy Google wywoła Twoją aplikację, wyświetli się ona użytkownikowi.

Wymagania

  1. Musisz mieć upoważnienie Google, na przykład „Po połączeniu Google będzie mieć uprawnienia do sterowania Twoimi urządzeniami”.
  2. Musisz poinformować, że konto użytkownika jest łączone z Google, a nie z konkretną usługą Google, taką jak Google Home czy Asystent Google.
  3. Na ekranie zgody musisz umieścić jasne wezwanie do działania i tekst „Zgadzam się i łączę”. Dzieje się tak, ponieważ użytkownicy muszą wiedzieć, jakie dane muszą udostępnić Google, aby połączyć ich konta.
  4. Musisz umożliwić użytkownikom powrót do gry lub anulowanie połączenia, jeśli zdecydują się nie tworzyć połączenia. Użyj sformułowania „Anuluj”.
  5. Musisz wdrożyć ten proces: po kliknięciu „Zgadzam się i połącz” musisz pokazać, że proces łączenia się udał, i automatycznie przekierować użytkownika z powrotem do aplikacji Google Home. Użytkownik powinien zobaczyć połączone urządzenie w aplikacji Google Home z Twoim działaniem. Gdy klikniesz „Anuluj”, musisz przekierować użytkownika z powrotem do aplikacji Google Home.

Rekomendacje

Zalecamy wykonanie tych czynności:

  1. Wyświetl Politykę prywatności Google. Umieść na ekranie zgody link do Polityki prywatności Google.

  2. Dane do udostępnienia. W jasny i zwięzły sposób wyjaśnij użytkownikom, jakich danych Google wymaga od Google i dlaczego.

  3. Możliwość odłączenia. Udostępnij użytkownikom mechanizm odłączania konta, np. adres URL do ich ustawień konta na Twojej platformie. Możesz też podać link do konta Google, na którym użytkownicy mogą zarządzać swoim połączonym kontem.

  4. Możliwość zmiany konta użytkownika. Zasugeruj użytkownikom metodę przełączenia kont. Jest to szczególnie przydatne, gdy użytkownicy mają wiele kont.

    • Jeśli użytkownik musi zamknąć ekran zgody, aby przełączyć konta, wyślij do Google błąd umożliwiający jego przywrócenie, aby mógł on zalogować się na odpowiednie konto za pomocą łączenia przez OAuth i przepływu implicit.
  5. Dodaj logo. Wyświetlaj logo swojej firmy na ekranie zgody. Umieść logo zgodnie ze wskazówkami dotyczącymi stylu. Jeśli chcesz też wyświetlać logo Google, zobacz Logo i znaki towarowe.

Ten rysunek pokazuje przykładowy ekran zgody z objaśnieniami poszczególnych wymagań i rekomendacji, które należy stosować podczas projektowania ekranu zgody użytkownika.
Rysunek 1. Wytyczne dotyczące projektowania ekranu zgody na łączenie kont

Skonfiguruj dla App Flip wykorzystujących protokół OAuth

W kolejnych sekcjach opisano wymagania wstępne dla App Flip z protokołem OAuth oraz sposoby konfigurowania App Flip projekt w Konsoli Actions.

Utwórz działanie związane z inteligentnym domem i skonfiguruj serwer OAuth 2.0

Przed skonfigurowaniem usługi App Flip musisz wykonać te czynności:

Skonfiguruj funkcję App Flip w Konsoli Actions

Z tej sekcji dowiesz się, jak skonfigurować App Flip w Konsola Actions.

  1. Wypełnij wszystkie pola w sekcji Informacje o kliencie OAuth. Jeśli App Flip nie jest obsługiwany, zamiast niego używana jest standardowa wersja OAuth.
  2. W sekcji Używaj aplikacji do łączenia kont(opcjonalnie) zaznacz Włącz w iOS.
  3. Wypełnij pole Uniwersalny link. Więcej informacji o uniwersalnych linkach, zobacz Zezwalanie aplikacjom i witrynom na tworzenie linków do Twoich treści.
  4. Jeśli chcesz opcjonalnie skonfigurować klienta, dodaj zakresy i kliknij Dodaj zakres w sekcji Skonfiguruj klienta (opcjonalnie).
  5. Kliknij Zapisz.

Możesz teraz przejść do następnej sekcji, aby zaimplementować App Flip w swoim systemie iOS lub Aplikacja Android.

Wdróż App Flip w swoich aplikacjach natywnych

Aby zaimplementować funkcję App Flip, musisz zmodyfikować kod autoryzacji użytkownika w swojej witrynie aby zaakceptować precyzyjny link od Google.

Przetestuj aplikację App Flip na swoim urządzeniu

Masz już utworzone działanie i skonfigurowano App Flip w konsoli oraz w swojej aplikacji, możesz przetestować usługę App Flip na urządzeniu mobilnym. Za pomocą Google Assistant app lub Google Home app (GHA), aby przetestować App Flip.

Aby przetestować funkcję App Flip z poziomu Google Assistant app, wykonaj te czynności:

  1. Otwórz konsolę Actions i wybierz projekt.
  2. Kliknij Przetestuj w menu nawigacyjnym u góry.
  3. Uruchom proces łączenia kont w aplikacji Google Assistant:
    1. Otwórz aplikację Google Assistant app
    2. Kliknij Ustawienia.
    3. Na karcie Assistant kliknij Sterowanie domem.
    4. Kliknij Dodaj(+).
    5. Wybierz działanie z listy dostawców. Będzie na liście poprzedzone ciągiem „[test]”. Gdy wybierzesz [test] działanie z powinna otworzyć się aplikacja.
    6. Sprawdź, czy aplikacja została uruchomiona, i rozpocznij testowanie procesu autoryzacji.

Aby przetestować działanie funkcji App Flip w aplikacji Google Home, wykonaj te czynności:

  1. Otwórz konsolę Actions i wybierz projekt.
  2. Kliknij Przetestuj w menu nawigacyjnym u góry.
  3. Uruchom proces łączenia kont w aplikacji Home:
    1. Otwórz Google Home app (GHA).
    2. Kliknij przycisk +.
    3. Kliknij Skonfiguruj urządzenie.
    4. Kliknij Masz już skonfigurowane?.
    5. Z listy dostawców wybierz działanie smart home. Będzie na liście poprzedzone ciągiem „[test]”. Gdy wybierzesz [test] działanie z powinna otworzyć się aplikacja.
    6. Sprawdź, czy aplikacja została uruchomiona, i rozpocznij testowanie procesu autoryzacji.