Übersicht

Integrationspfad auswählen

Wählen Sie den Pfad aus, der Ihren Anforderungen am besten entspricht:

Pfad Optimal für Weitere Informationen
Universal Commerce Protocol (UCP) Händler und Einzelhändler UCP-Dokumentation
Standardkontoverknüpfung Smart Home, TV und YouTube Google Docs

Mit der Kontoverknüpfung können Inhaber von Google-Konten schnell, nahtlos und sicher eine Verbindung zu Ihren Diensten herstellen. Sie können die Google-Kontoverknüpfung implementieren, um die Daten eines Nutzers von Ihrer Plattform für Google-Apps und ‑Dienste freizugeben.

Mit dem sicheren OAuth 2.0-Protokoll können Sie das Google-Konto eines Nutzers sicher mit seinem Konto auf Ihrer Plattform verknüpfen und so Google-Anwendungen und ‑Geräten Zugriff auf Ihre Dienste gewähren.

Nutzer können ihre Konten verknüpfen oder die Verknüpfung aufheben und optional beim Drittanbieterdienst ein neues Konto mit einer Google-Kontoverknüpfung erstellen.

Anwendungsfälle

Einige Gründe für die Implementierung der Google-Kontoverknüpfung:

Funktionen und Anforderungen

In der folgenden Tabelle sind die Unterstützung und Empfehlungen für die einzelnen Verknüpfungsvorgänge definiert.

Verknüpfungsvorgang Standardfunktionen UCP-Funktionen
App-Flip Empfohlen Empfohlen
Optimierte Verknüpfung Empfohlen Empfohlen
OAuth-Verknüpfung Erforderlich (Fallback) Erforderlich (Fallback)
OAuth 2.1 Empfohlen Empfohlen

Agentische Entwicklung (MCP und UCP)

Large Language Models (LLMs) und KI-Agenten erfordern eine robuste Authentifizierung, um auf Nutzerdaten zuzugreifen. Die Google-Kontoverknüpfung unterstützt diese neuen Paradigmen:

  • Model Context Protocol (MCP): GAL fungiert als Sicherheits-Handshake. Agenten verwenden OAuth 2.1-Tokens, um Ihre MCP-Servertools sicher abzufragen.

  • Universal Commerce Protocol (UCP): Ermöglicht Shopping-Agenten den sicheren Zugriff auf Nutzerprofile und Zahlungsvektoren.

  • Verbessern Sie den Datenschutz der Nutzer, indem Sie benutzerdefinierte Bereiche festlegen, um nur die erforderlichen Daten freizugeben. Steigern Sie das Vertrauen der Nutzer, indem Sie klar definieren, wie ihre Daten verwendet werden.

  • Der Zugriff auf Daten und Dienste, die auf Ihrer Plattform gehostet werden, kann durch Aufheben der Kontoverknüpfung widerrufen werden. Wenn Sie einen optionalen Endpunkt für den Tokenwiderruf implementieren, bleiben Sie mit von Google initiierten Ereignissen synchron. Mit Cross-Account Protection (RISC) können Sie Google über alle Ereignisse zum Aufheben der Verknüpfung informieren, die auf Ihrer Plattform stattfinden.

Abläufe für die Kontoverknüpfung

Es gibt drei Abläufe für die Google-Kontoverknüpfung, die alle auf OAuth basieren und bei denen Sie OAuth 2.0-konforme Autorisierungs- und Tokenaustausch-Endpunkte verwalten oder steuern müssen.

Während des Verknüpfungsvorgangs stellen Sie Google Zugriffstokens für einzelne Google-Konten aus, nachdem Sie die Zustimmung der Kontoinhaber erhalten haben, ihre Konten zu verknüpfen und Daten freizugeben.

OAuth-Verknüpfung

Dies ist der OAuth-Verknüpfungsvorgang, bei dem Nutzer zum Verknüpfen auf Ihre Website weitergeleitet werden. Der Nutzer wird auf Ihre Website weitergeleitet, um sich in seinem Konto anzumelden. Nach der Anmeldung stimmt der Nutzer zu, seine Daten in Ihrem Dienst für Google freizugeben. An diesem Punkt werden das Google-Konto des Nutzers und Ihr Dienst verknüpft.

Die OAuth-Verknüpfung unterstützt die impliziten OAuth-Abläufe und die OAuth-Abläufe mit Autorisierungscode. Ihr Dienst muss einen OAuth 2.0-konformen Autorisierungsendpunkt für den impliziten Ablauf hosten und sowohl einen Autorisierungs- als auch einen Tokenaustausch-Endpunkt bereitstellen, wenn der Ablauf mit Autorisierungscode verwendet wird.

Abbildung 1. Kontoverknüpfung auf dem Smartphone eines Nutzers mit OAuth-Verknüpfung

OAuth-basierte App-Flip-Verknüpfung („App-Flip“)

Ein OAuth-Ablauf, bei dem Nutzer zum Verknüpfen zu Ihrer App weitergeleitet werden.

Bei der OAuth-basierten App-Flip-Verknüpfung werden Nutzer zwischen Ihren verifizierten Android- oder iOS-Apps und der Google-Plattform hin- und hergeleitet, um die vorgeschlagenen Änderungen beim Datenzugriff zu prüfen und ihre Zustimmung zu erteilen, ihr Konto auf Ihrer Plattform mit ihrem Google-Konto zu verknüpfen. Damit App-Flip funktioniert, muss Ihr Dienst die OAuth-Verknüpfung oder die OAuth-basierte Verknüpfung mit „Über Google anmelden“ über den Ablauf mit Autorisierungscode unterstützen.

App-Flip wird sowohl für Android als auch für iOS unterstützt.

So gehts :

Die Google App prüft, ob Ihre App auf dem Gerät des Nutzers installiert ist:

  • Wenn die App gefunden wird, wird der Nutzer zu Ihrer App weitergeleitet. Ihre App holt die Zustimmung des Nutzers ein, das Konto mit Google zu verknüpfen, und leitet den Nutzer dann zurück zur Google-Oberfläche.
  • Wenn die App nicht gefunden wird oder ein Fehler während des App-Flip-Verknüpfungsvorgangs auftritt, wird der Nutzer zum optimierten oder OAuth-Verknüpfungsvorgang weitergeleitet.

Abbildung 2. Kontoverknüpfung auf dem Smartphone eines Nutzers mit App-Flip

OAuth-basierte optimierte Verknüpfung („Optimiert“)

Bei der OAuth-basierten optimierten Verknüpfung mit „Über Google anmelden“ wird „Über Google anmelden“ zusätzlich zur OAuth-Verknüpfung verwendet. So können Nutzer den Verknüpfungsvorgang abschließen, ohne die Google-Oberfläche zu verlassen. Dadurch werden Reibungsverluste und Abbrüche reduziert. Die OAuth-basierte optimierte Verknüpfung bietet die beste Nutzererfahrung mit nahtloser Anmeldung, Kontoerstellung und Konten verknüpfung, indem „Über Google anmelden“ mit der OAuth-Verknüpfung kombiniert wird. Ihr Dienst muss OAuth 2.0-konforme Autorisierungs- und Tokenaustausch-Endpunkte unterstützen. Außerdem muss Ihr Tokenaustausch-Endpunkt JSON-Web-Token-Assertionen (JWT) unterstützen und die erforderlichen check- und get-Intents sowie optional das create-Intent implementieren.

So gehts :

Google bestätigt das Nutzerkonto und gibt diese Informationen an Sie weiter:

  • Wenn in Ihrer Datenbank ein Konto für den Nutzer vorhanden ist, verknüpft der Nutzer sein Google-Konto erfolgreich mit seinem Konto in Ihrem Dienst.
  • Wenn in Ihrer Datenbank kein Konto für den Nutzer vorhanden ist und die Kontoerstellung von Ihrem Dienst unterstützt wird, kann der Nutzer entweder ein neues Drittanbieterkonto mit den von Google bestätigten Informationen (E-Mail-Adresse, Name und Profilbild) erstellen oder sich anmelden und mit einer anderen E-Mail-Adresse über die OAuth-Verknüpfung verknüpfen.

Abbildung 3. Kontoverknüpfung auf dem Smartphone eines Nutzers mit optimierter Verknüpfung

Welchen Ablauf sollten Sie verwenden?

Wir empfehlen, alle Abläufe zu implementieren, damit Nutzer die bestmögliche Verknüpfungserfahrung erhalten. Die optimierten und App-Flip-Abläufe reduzieren Reibungsverluste bei der Verknüpfung, da Nutzer den Verknüpfungsvorgang in nur wenigen Schritten abschließen können. Der OAuth-Verknüpfungsvorgang erfordert den geringsten Aufwand und ist ein guter Ausgangspunkt. Danach können Sie die anderen Verknüpfungsvorgänge hinzufügen.

Mit Tokens arbeiten

Die Google-Kontoverknüpfung basiert auf Standard-OAuth 2.0-Tokenmechanismen. Sie stellen Google Zugriffstokens und Aktualisierungstokens aus, nachdem der Nutzer zugestimmt hat, sein Konto zu verknüpfen.

  • Zugriffstokens: Kurzlebige Tokens, die von Google verwendet werden, um auf Ihre APIs zuzugreifen.
  • Aktualisierungstokens: Langlebige Tokens, die von Google verwendet werden, um neue Zugriffstokens abzurufen, wenn sie ablaufen.

Ausführliche Protokollverträge und Parameteranforderungen finden Sie unter dem Tokenaustausch-Endpunkt.

Persistente Verknüpfung

Die persistente Verknüpfung ist eine grundlegende Voraussetzung für stabile Integrationen. Sie sorgt dafür, dass Nutzerkonten auch bei vorübergehenden Netzwerkausfällen oder regelmäßigen Aktualisierungen der Anmeldedaten verknüpft bleiben.

Verwenden Sie für die Implementierung der persistenten Verknüpfung einen Ansatz mit gleitendem Fenster: Verlängern Sie das Ablaufdatum des vorhandenen Aktualisierungstokens, anstatt es zu rotieren (siehe RFC 6749, Abschnitt 6). So werden Race-Bedingungen und unbeabsichtigte Aufhebungen der Verknüpfung verhindert, die auftreten können, wenn ein neues Aktualisierungstoken ausgestellt, aber nicht erfolgreich von Google empfangen oder gespeichert wird.

Bei Google registrieren

Wir benötigen Details zu Ihrer OAuth 2.0-Einrichtung und müssen Anmeldedaten freigeben, um die Kontoverknüpfung zu aktivieren. Weitere Informationen finden Sie unter Registrierung.