Przegląd

Oparte na protokole OAuth łączenie aplikacji (Odwracanie aplikacji) umożliwia użytkownikom łatwe i szybkie połączenie kont w systemie uwierzytelniania z ich kontami Google. Jeśli aplikacja zostanie zainstalowana na telefonie użytkownika po zainicjowaniu procesu łączenia kont, zostanie ona płynnie przekierowana do aplikacji, aby uzyskać autoryzację użytkownika.

Takie podejście zapewnia szybsze i prostsze procesy łączenia, ponieważ użytkownik nie musi ponownie wpisywać swojej nazwy użytkownika i hasła, aby się uwierzytelnić. Zamiast tego App Flip wykorzystuje dane logowania z konta użytkownika w Twojej aplikacji. Gdy użytkownik połączy swoje konto Google z Twoją aplikacją, może skorzystać z wszelkich utworzonych przez Ciebie integracji.

Możesz to zrobić zarówno w przypadku aplikacji na iOS, jak i na Androida.

Ten wykres przedstawia czynności, jakie musi wykonać użytkownik, aby połączyć swoje konto Google z Twoim systemem uwierzytelniania. Pierwszy zrzut ekranu pokazuje, jak użytkownik może wybrać aplikację, jeśli ma z nim połączone konto Google. Drugi zrzut ekranu przedstawia potwierdzenie połączenia konta Google z aplikacją. Trzeci zrzut ekranu przedstawia konto użytkownika połączone z aplikacją Google.
Rysunek 1. Łączenie kont na telefonie użytkownika za pomocą App Flip.

Wymagania

Aby zaimplementować odwracanie aplikacji, musisz spełniać te wymagania:

  • Musisz mieć aplikację na Androida lub iOS.
  • Musisz być właścicielem i dostawcą serwera OAuth 2.0, który obsługuje przepływ kodu autoryzacji OAuth 2.0, oraz nim zarządzać.

Więcej informacji o przepływie kodu autoryzacji łączenia OAuth znajdziesz w artykule o implementowaniu serwera OAuth.

Wskazówki dotyczące wyglądu

W tej sekcji opisano wymagania projektowe i rekomendacje związane z ekranem zgody na połączenie konta aplikacji. Gdy Google wywoła aplikację, wyświetli się ekran zgody.

Wymagania

  1. Musisz poinformować, że konto użytkownika jest połączone z Google, a nie z konkretną usługą Google, taką jak Google Home czy Asystent Google.

Zalecenia

Zalecamy wykonanie tych czynności:

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

  2. Dane do udostępnienia. Stosuj jasne i zwięzłe sformułowania, których użytkownik potrzebuje, i wyjaśnij, jakich danych Google potrzebuje i dlaczego.

  3. Stosuj jednoznaczne wezwania do działania. Jasno umieść wezwanie do działania na ekranie zgody, np. „Zgadzam się i łączę”. Użytkownicy muszą wiedzieć, jakie dane muszą udostępnić Google, by połączyć swoje konta.

  4. Możliwość anulowania. Zapewnij użytkownikom możliwość powrotu lub anulowania subskrypcji, jeśli nie chcą tworzyć linków.

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

  6. Możliwość zmiany konta użytkownika. Zasugeruj użytkownikom zmianę swojego konta. Jest to szczególnie przydatne, gdy użytkownicy mają zwykle kilka kont.

    • Jeśli użytkownik musi zamknąć ekran zgody, aby przełączyć konta, wyślij do Google opis możliwego do odzyskania błędu, aby mógł zalogować się na wybrane konto przy użyciu łączenia OAuth i procesu domyślnego.
  7. Logo. Wyświetlaj logo swojej firmy na ekranie zgody. Umieść swoje logo zgodnie ze wskazówkami dotyczącymi stylu. Jeśli chcesz też wyświetlać logo Google, zobacz Logo i znaki towarowe.

Ten przykładowy ekran pokazuje przykładową prośbę o zgodę na wykorzystanie danych i odwołania do poszczególnych wymagań oraz zaleceń, których należy przestrzegać podczas projektowania ekranu zgody użytkownika.
Rysunek 2. Wskazówki dotyczące projektowania ekranu zgody na połączenie kont.

Konfigurowanie przewracania aplikacji opartej na protokole OAuth

W sekcjach poniżej opisano wymagania wstępne dotyczące przenoszenia aplikacji korzystającej z protokołu OAuth oraz informacje o konfigurowaniu projektu Przewracanie aplikacji w konsoli Actions.

Utwórz działanie i skonfiguruj serwer OAuth 2.0

Zanim skonfigurujesz odwrócenie aplikacji, musisz wykonać te czynności:

Konfigurowanie odwrócenia aplikacji w konsoli Actions

Z sekcji poniżej dowiesz się, jak skonfigurować przerzucenie aplikacji w konsoli Actions.

  1. W górnym panelu nawigacyjnym kliknij Programuj. Następnie w menu nawigacyjnym po lewej stronie kliknij Łączenie kont.
  2. Przesuń przełącznik obok opcji Łączenie kont.
  3. W sekcji Tworzenie konta wybierz Nie, chcę zezwolić na tworzenie konta tylko na mojej stronie.
  4. Kliknij Dalej.
  5. W sekcji Typ połączenia wybierz z menu Protokół OAuth i Kod autoryzacji.
  6. Kliknij Dalej.
  7. Wypełnij wszystkie pola w sekcji Informacje o kliencie OAuth. (Jeśli przerzucenie aplikacji nie jest obsługiwane, jako kreacji zastępczej używana jest standardowa protokół OAuth).
  8. Kliknij Dalej.
  9. W sekcji Użyj aplikacji do łączenia kont (opcjonalnie) zaznacz Włącz na iOS.
  10. Wypełnij pole Uniwersalny link. Więcej informacji o uniwersalnych linkach znajdziesz w artykule Zezwalanie aplikacjom i stronom internetowym na tworzenie linków do Twoich treści .
  11. Jeśli chcesz opcjonalnie skonfigurować klienta, dodaj zakresy i kliknij Dodaj zakres w sekcji Skonfiguruj klienta (opcjonalnie). Jeśli nie, kliknij Dalej.
  12. W sekcji Instrukcje testowania wpisz test (lub dowolny inny ciąg) jako zmienną. (Wypełnienie tego pola nazwą konta testowego jest konieczne tylko wtedy, gdy rzeczywiście przesyłasz akcję do opublikowania).
  13. Kliknij Zapisz.

Możesz teraz przejść do następnej sekcji, aby zaimplementować odwracanie aplikacji w aplikacji na iOS lub Androida.

Implementowanie funkcji odwracania aplikacji w aplikacjach natywnych

Aby zaimplementować odwrót, musisz zmodyfikować kod autoryzacji użytkownika w aplikacji tak, aby akceptował precyzyjny link od Google.

Przetestuj funkcję App Flip na swoim urządzeniu

Po utworzeniu działania i skonfigurowaniu przewracania aplikacji w konsoli i w aplikacji możesz przetestować tę funkcję na urządzeniu mobilnym. Możesz ją przetestować za pomocą aplikacji Asystent Google.

Aby przetestować przerzucenie aplikacji z poziomu aplikacji Asystent, wykonaj te czynności:

  1. Otwórz Konsolę Actions i wybierz projekt.
  2. W menu u góry kliknij Przetestuj.
  3. Uruchom proces łączenia kont w aplikacji Asystent:
    1. Otwórz aplikację Asystent Google.
    2. Kliknij Ustawienia.
    3. Na karcie Asystent kliknij Sterowanie domem.
    4. Kliknij Dodaj(+).
    5. Wybierz akcję z listy dostawców. Na liście będzie przed nim prefiks „[test]”. Gdy wybierzesz z listy akcję [testowe], powinna ona otworzyć Twoją aplikację.
    6. Sprawdź, czy Twoja aplikacja została wprowadzona na rynek, i rozpocznij testowanie przepływu autoryzacji.