Kontoverknüpfung
Übersicht
Wenn deine Aktion eine Ergänzung vorhandener Apps auf verschiedenen Plattformen ist (z. B. im Web oder auf Android), kannst du die Kontoverknüpfung verwenden, um die Einstellungen der Nutzer sicher für alle Plattformen verfügbar zu machen. So wird für eine einheitliche plattformübergreifende Nutzung gesorgt.
Für die Kontoverknüpfung bei Actions on Google werden Google Log-in, das sichere Authentifizierungssystem von Google, und optional OAuth 2.0 (ein branchenübliches Protokoll für die Autorisierung) verwendet.
Weitere technische Informationen finden Sie auf unserer Entwicklerwebsite.
Verknüpfung
- Finde eine Übereinstimmung für das Konto in deinem Authentifizierungssystem (wenn der Nutzer deine Aktion bereits auf einer deiner anderen Plattformen verwendet hat)
- Neues Konto in Ihrem Authentifizierungssystem für einen neuen Nutzer erstellen
Die drei Verknüpfungsmethoden
Es gibt drei Methoden, Konten zu verknüpfen:
Google Log-in
Mit Google Log-in für Assistant kann Ihre Aktion während einer Unterhaltung den Zugriff auf das Google-Profil anfordern, z. B. den Namen, die E-Mail-Adresse und das Profilbild des Nutzers. Der Nutzer kann den gesamten Vorgang per Sprachbefehl ausführen, was eine reibungslose Anmeldung ermöglicht.
Das Google Log-in kann in folgenden Fällen verwendet werden:
- Deine Aktionen sind nur auf Assistant ausgerichtet
- Sie haben kein Authentifizierungssystem.
- Du hast ein Authentifizierungssystem und möchtest nur Nutzer erreichen, die sich mit ihrer @gmail.com-Adresse bei deinen bestehenden Apps angemeldet haben.
OAuth und Google Log-in
Durch den OAuth- und den Google Log-in-Verknüpfungstyp wird zusätzlich zur OAuth-basierten Kontoverknüpfung Google Log-in hinzugefügt. So können Google-Nutzer*innen sprachbasierte Verknüpfungen herstellen. Nutzer, die sich mit einer nicht von Google stammenden Identität bei Ihrem Dienst registriert haben, können dies tun.
Zur Verwendung dieses Ablaufs müssen Sie einen der unterstützten OAuth 2-Standardabläufe erweitern, um die Unterstützung von Google-eigenen Erweiterungen des Protokolls hinzuzufügen.
In folgenden Fällen sollten Sie OAuth und Google Log-in verwenden:
- Sie haben plattformübergreifende Aktionen
- Sie haben ein Authentifizierungssystem und möchten Nutzern erlauben, sich mit Nicht-@gmail.com-Adressen zu verbinden
- Sie möchten Konten mit Google-Profilinformationen verknüpfen
- Sie müssen neue Konten mit den Google-Profilinformationen erstellen (optional)
OAuth
Der OAuth-Kontoverknüpfungstyp unterstützt zwei branchenübliche OAuth 2.0-Abläufe:
- implizite Code-Abläufe
- Autorisierungscode-Abläufe
Von diesem Vorgang wird abgeraten, da die Nutzerinteraktion von Sprache auf Bildschirm übertragen werden muss.
In folgenden Fällen empfiehlt sich die Verwendung von OAuth:
- Sie haben bereits einen OAuth 2-Server implementiert und können den Endpunkt für den Tokenaustausch nicht erweitern, um die Unterstützung der Protokolle von Google für die automatische Verknüpfung und die Kontoerstellung über ein ID-Token zu erweitern.
Weitere Informationen finden Sie im OAuth-Entwicklerleitfaden.