Przegląd

Wybierz ścieżkę integracji

Wybierz ścieżkę, która najlepiej odpowiada Twoim potrzebom:

Ścieżka	Urządzenia	Więcej informacji
Protokół Universal Commerce Protocol (UCP)	Sprzedawcy i detaliści.	Dokumentacja UCP
Standardowe łączenie kont	Inteligentny dom, telewizor i YouTube.	Dokumenty

Uwaga: te ścieżki integracji się uzupełniają. Jeśli wdrażasz UCP, zalecamy zapoznanie się z przewodnikiem UCP Identity Linking, w którym znajdziesz wymagania dotyczące poszczególnych usług, oraz z tą dokumentacją, w której znajdziesz szczegółowe informacje o podstawowej implementacji OAuth.

Łączenie kont umożliwia posiadaczom kont Google szybkie, bezproblemowe i bezpieczne łączenie się z Twoimi usługami. Możesz wdrożyć połączenie kont Google, aby udostępniać dane użytkownika z Twojej platformy aplikacjom i usługom Google.

Bezpieczny protokół OAuth 2.0 umożliwia bezpieczne połączenie konta Google użytkownika z jego kontem na Twojej platformie, dzięki czemu aplikacje i urządzenia Google uzyskują dostęp do Twoich usług.

Użytkownicy mogą łączyć lub rozłączać swoje konta i opcjonalnie tworzyć nowe konto na Twojej platformie za pomocą funkcji łączenia kont Google.

Przypadki użycia

Oto niektóre powody, dla których warto wdrożyć łączenie kont Google:

• udostępniać dane użytkownika z Twojej platformy aplikacjom i usługom Google;

• Zintegruj się z Zakupami Google i platformami AI (wyszukiwarka, Gemini) za pomocą protokołu Universal Commerce Protocol (UCP).

• Odtwarzaj treści wideo i filmy za pomocą Google TV.

• zarządzanie połączonymi urządzeniami Google Smart Home i sterowanie nimi za pomocą aplikacji Google Home i Asystenta Google, np. „OK Google, włącz światła”;

• Twórz dostosowane do użytkownika funkcje i sposoby działania Asystenta Google za pomocą akcji konwersacyjnych, np. „OK Google, zamów to, co zwykle, w Starbucks”.

• Umożliwiać użytkownikom zdobywanie nagród za oglądanie kwalifikujących się transmisji na żywo w YouTube po połączeniu konta Google z kontem partnera oferującego nagrody.

• wstępne wypełnianie nowych kont podczas rejestracji danymi udostępnionymi za zgodą użytkownika z profilu konta Google;

Możliwości i wymagania

Poniższa tabela zawiera informacje o obsłudze i rekomendacjach dotyczących każdego procesu łączenia.

Proces łączenia	Funkcje standardowe	Funkcje UCP
Przełączanie aplikacji	Zalecane	Zalecane
Uproszczone łączenie	Zalecane	Zalecane
Łączenie OAuth	Wymagane (reklama zastępcza)	Wymagane (reklama zastępcza)
OAuth 2.1	Zalecane	Zalecane

Agentowe środowisko do programowania (MCP i UCP)

Duże modele językowe (LLM) i agenty AI wymagają solidnego uwierzytelniania, aby uzyskać dostęp do danych użytkowników. Połączenie konta Google obsługuje te nowe paradygmaty:

• Model Context Protocol (MCP): GAL działa jako uzgadnianie połączenia zabezpieczonego. Agenty używają tokenów OAuth 2.1 do bezpiecznego wysyłania zapytań do narzędzi na serwerze MCP.

• Universal Commerce Protocol (UCP): umożliwia agentom zakupów bezpieczny dostęp do profili użytkowników i wektorów płatności.

• Zwiększanie prywatności użytkowników przez definiowanie zakresów niestandardowych, aby udostępniać tylko niezbędne dane, oraz zwiększanie zaufania użytkowników przez jasne określanie, w jaki sposób ich dane są wykorzystywane.

• Dostęp do danych i usług hostowanych na Twojej platformie można cofnąć, rozłączając konta. Wdrożenie opcjonalnego punktu końcowego odwoływania tokenów umożliwia synchronizację z wydarzeniami inicjowanymi przez Google, a ochrona międzykontowa (RISC) pozwala powiadamiać Google o wszelkich wydarzeniach odłączania, które mają miejsce na Twojej platformie.

Uwaga: większość dokumentacji OAuth 2.0 dotyczącej Platformy tożsamości Google zawiera informacje o tym, jak logować użytkowników za pomocą ich kont Google i uzyskiwać autoryzację do wywoływania interfejsów API Google w ich imieniu. Łączenie kont Google obejmuje odwrotny przypadek, w którym użytkownik usługi Google może uwierzytelnić się na Twojej platformie i wywoływać interfejsy API Twojej usługi. Jeśli chcesz używać OAuth 2.0 na potrzeby dostępu do interfejsów API Google, zapoznaj się z dokumentacją klienta OAuth 2.0.

Procesy łączenia kont

Istnieją 3 procesy łączenia kont Google, które są oparte na protokole OAuth i wymagają zarządzania punktami końcowymi autoryzacji i wymiany tokenów zgodnymi z OAuth 2.0 lub kontrolowania ich.

Podczas procesu łączenia wydajesz Google tokeny dostępu do poszczególnych kont Google po uzyskaniu zgody właścicieli kont na połączenie kont i udostępnianie danych.

Łączenie OAuth

Jest to proces łączenia OAuth, który przekierowuje użytkowników do Twojej witryny w celu połączenia. Użytkownik zostaje przekierowany na Twoją stronę, aby zalogować się na swoje konto. Po zalogowaniu użytkownik wyraża zgodę na udostępnianie swoich danych w Twojej usłudze firmie Google. W tym momencie konto Google użytkownika i Twoja usługa zostaną połączone.

Łączenie OAuth obsługuje przepływy kodu autoryzacji i niejawne przepływy OAuth. Usługa musi hostować punkt końcowy autoryzacji zgodny z OAuth 2.0 w przypadku przepływu niejawnego oraz udostępniać punkt końcowy autoryzacji i wymiany tokenów w przypadku przepływu kodu autoryzacji.

Ostrzeżenie: w przypadku przepływów MCP, UCP i przepływów opartych na działaniach agenta protokół OAuth 2.1 jest obowiązkowy, a przepływ niejawny jest nieobsługiwany. Zamiast tego użyj przepływu kodu autoryzacji.

Uwaga: w przypadku wszystkich integracji łączenia kont wymagane jest wdrożenie łączenia za pomocą protokołu OAuth, ponieważ jest to metoda rezerwowa w przypadku przepływów App Flip i uproszczonych.

Rysunek 1. Łączenie kont na telefonie użytkownika za pomocą protokołu OAuth

Połączenie przez przejście do aplikacji oparte na OAuth („przejście do aplikacji”)

Sposób obsługi protokołu OAuth, który kieruje użytkowników do aplikacji w celu połączenia.

Łączenie aplikacji oparte na OAuth prowadzi użytkowników podczas przechodzenia między zweryfikowanymi aplikacjami mobilnymi na Androida lub iOS a platformą Google, aby mogli przejrzeć proponowane zmiany w dostępie do danych i wyrazić zgodę na połączenie konta na Twojej platformie z kontem Google. Aby włączyć App Flip, usługa musi obsługiwać łączenie za pomocą protokołu OAuth lub łączenie za pomocą Logowania przez Google opartego na protokole OAuth przy użyciu procesu kodu autoryzacji.

Funkcja App Flip jest obsługiwana na Android i iOS.

Jak to działa:

Aplikacja Google sprawdza, czy Twoja aplikacja jest zainstalowana na urządzeniu użytkownika:

• Jeśli aplikacja zostanie znaleziona, użytkownik zostanie „przekierowany” do Twojej aplikacji. Aplikacja uzyskuje zgodę użytkownika na połączenie konta z Google, a następnie „przekierowuje” go z powrotem do usługi Google.
• Jeśli aplikacja nie zostanie znaleziona lub podczas procesu łączenia z przełączaniem aplikacji wystąpi błąd, użytkownik zostanie przekierowany do uproszczonego procesu łączenia lub procesu łączenia OAuth.

Rysunek 2. Łączenie kont na telefonie użytkownika za pomocą funkcji App Flip

Uproszczone łączenie oparte na OAuth („Uproszczone”)

Uproszczone łączenie za pomocą Logowania przez Google opartego na OAuth dodaje Logowanie przez Google do łączenia opartego na OAuth, dzięki czemu użytkownicy mogą ukończyć proces łączenia bez opuszczania usługi Google, co zmniejsza trudności i liczbę rezygnacji. Uproszczone łączenie oparte na OAuth zapewnia najlepszą wygodę użytkownika dzięki bezproblemowemu logowaniu, tworzeniu konta i łączeniu konta przez połączenie logowania za pomocą Google z łączeniem OAuth. Usługa musi obsługiwać punkty końcowe autoryzacji i wymiany tokenów zgodne z OAuth 2.0. Dodatkowo punkt końcowy wymiany tokenów musi obsługiwać asercje tokena sieciowego JSON (JWT) i wdrażać wymagane intencje check i get oraz opcjonalnie intencję create.

Uwaga: w tym procesie użytkownik nigdy nie opuszcza usługi Google, więc aby proces działał prawidłowo, Google musi wyświetlać prośbę o zgodę w imieniu firmy zewnętrznej.

Jak to działa:

Google potwierdza konto użytkownika i przekazuje Ci te informacje:

• Jeśli w Twojej bazie danych istnieje konto użytkownika, użytkownik pomyślnie połączy swoje konto Google z kontem w Twojej usłudze.
• Jeśli w Twojej bazie danych nie ma konta użytkownika, a usługa obsługuje tworzenie kont, użytkownik może utworzyć nowe konto usługi zewnętrznej, korzystając z informacji przekazanych przez Google (adres e-mail, imię i nazwisko oraz zdjęcie profilowe), lub zalogować się i połączyć z innym adresem e-mail za pomocą połączenia OAuth.

Rysunek 3. Łączenie kont na telefonie użytkownika za pomocą uproszczonego łączenia

Którego procesu należy użyć?

Aby zapewnić użytkownikom jak najlepsze wrażenia związane z łączeniem kont, zalecamy wdrożenie wszystkich ścieżek. Uproszczone i aplikacyjne procesy przełączania zmniejszają trudności związane z łączeniem, ponieważ użytkownicy mogą ukończyć ten proces w kilku krokach. Proces łączenia OAuth wymaga najmniej wysiłku i jest dobrym punktem wyjścia. Następnie możesz dodać inne procesy łączenia.

Uwaga: przepływ łączenia OAuth jest wymagany w przypadku wszystkich integracji, ponieważ jest to alternatywa dla innych przepływów.

Praca z tokenami

Połączenie konta Google opiera się na standardowych mechanizmach tokenów OAuth 2.0. Po wyrażeniu przez użytkownika zgody na połączenie konta wydajesz Google tokeny dostępu i tokeny odświeżania.

• Tokeny dostępu: krótkotrwałe tokeny używane przez Google do uzyskiwania dostępu do Twoich interfejsów API.
• Tokeny odświeżania: długotrwałe tokeny używane przez Google do uzyskiwania nowych tokenów dostępu po wygaśnięciu poprzednich.

Szczegółowe informacje o umowach protokołu i wymaganiach dotyczących parametrów znajdziesz w artykule Punkt końcowy wymiany tokenów.

Trwałe linkowanie

Trwałe linkowanie jest podstawowym wymaganiem w przypadku stabilnych integracji. Dzięki temu konta użytkowników pozostają połączone nawet w przypadku przejściowych awarii sieci lub okresowego odświeżania danych logowania.

Aby wdrożyć trwałe linkowanie, zastosuj metodę „okna przesuwnego”: zamiast obracać istniejący token odświeżania, przedłuż jego ważność (zgodnie z sekcją 6 RFC 6749). Zapobiega to sytuacjom wyścigu i niezamierzonemu odłączeniu, które mogą wystąpić, jeśli zostanie wydany nowy token odświeżania, ale nie zostanie on pomyślnie odebrany ani zapisany przez Google.

Zarejestruj się przez Google

Aby umożliwić połączenie kont, potrzebujemy szczegółów konfiguracji OAuth 2.0 i danych logowania. Szczegółowe informacje znajdziesz w sekcji rejestracja.