Warnung:Diese Daten werden gemäß der Richtlinie zu Google-Nutzerdaten bereitgestellt. Bitte lesen Sie sich die Richtlinien durch und halten Sie sie ein. Andernfalls kann das zu einem Projekt oder einem Konto führen.

Referenz zur Anmeldung über die Google HTML API

Auf dieser Referenzseite wird die HTML-Datenattribute-API von „Über Google anmelden“ beschrieben. Sie können die API verwenden, um die Aufforderung von One Tap oder auf der Schaltfläche „Über Google anmelden“ auf Ihren Webseiten anzuzeigen.

Element mit der ID &g_id_onload"

Du kannst die Attribute „Über Google anmelden“ in alle sichtbaren oder unsichtbaren Elemente wie <div> und <span> einfügen. Die einzige Anforderung besteht darin, dass die Element-ID auf g_id_onload festgelegt ist. Verwende diese ID nicht in mehreren Elementen.

Datenattribute

In der folgenden Tabelle sind die Datenattribute mit Beschreibungen aufgeführt:

Attribut
data-client_id Client-ID Ihrer Anwendung
data-auto_prompt Google One-Display anzeigen.
data-auto_select Aktiviert die automatische Auswahl bei Google One Tap.
data-login_uri URL Ihres Anmeldeendpunkts
data-callback Name der JavaScript-ID-Token-Handler-Funktion
data-native_login_uri URL des Handlers für Anmeldedaten von Passwörtern
data-native_callback Name der Funktion des JavaScript-Passwort-Handler-Handlers
data-native_id_param Der Parametername für den Wert credential.id
data-native_password_param Der Parametername für den Wert credential.password
data-cancel_on_tap_outside Mit dieser Einstellung wird festgelegt, ob die Aufforderung abgebrochen werden soll, wenn der Nutzer auf eine Stelle außerhalb der Aufforderung klickt.
data-prompt_parent_id Die DOM-ID des Containerelements für One Tap-Aufforderung
data-skip_prompt_cookie Überspringt One Tap, wenn das angegebene Cookie einen nicht leeren Wert hat.
data-nonce Ein zufälliger String für ID-Tokens
data-context Titel und Wörter in der One-Touch-Aufforderung
data-moment_callback Der Funktionsname des Benachrichtigungs-Listeners für die UI-Statusmeldung
data-state_cookie_domain Wenn Sie One Tap in der übergeordneten Domain und ihren Subdomains aufrufen müssen, übergeben Sie die übergeordnete Domain an dieses Attribut, damit ein einzelnes freigegebenes Cookie verwendet wird.
data-ux_mode UX-Vorgang für die Schaltfläche „Über Google anmelden“
data-allowed_parent_origin Die Ursprünge, in denen der Zwischen-iFrame eingebettet werden darf. One Tap wird im Zwischen-iFrame-Modus ausgeführt, wenn dieses Attribut vorhanden ist.
data-intermediate_iframe_close_callback Überschreibt das Standardverhalten für Zwischen-iFrames, wenn Nutzer One Tap manuell schließen.
data-itp_support Hiermit wird die aktualisierte UI für One Tap auf ITP-Browsern aktiviert.

Attributtypen

Die folgenden Abschnitte enthalten Details zu den einzelnen Attributen und ein Beispiel.

Daten-Client-ID

Dieses Attribut ist die Client-ID Ihrer App, die in der Google Developers Console gefunden und erstellt wird. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Ja data-client_id="CLIENT_ID.apps.googleusercontent.com"

data-auto_prompt

Dieses Attribut bestimmt, ob One Tap angezeigt wird oder nicht. Der Standardwert ist true. Wenn der Wert false ist, wird Google One Tap nicht angezeigt. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
boolean Optional data-auto_prompt="true"

Automatische Auswahl der Daten

Dieses Attribut bestimmt, ob ein ID-Token automatisch ohne Nutzerinteraktion zurückgegeben wird, wenn Ihre App nur von einer Google-Sitzung genehmigt wurde. Der Standardwert ist false. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
boolean Optional data-auto_select="true"

data-login_uri

Dieses Attribut ist der URI Ihres Anmeldeendpunkts. Kann weggelassen werden, wenn die aktuelle Seite Ihre Anmeldeseite ist. In diesem Fall werden die Anmeldedaten standardmäßig auf dieser Seite gepostet.

Die Antwort mit den ID-Tokens wird an Ihren Anmeldeendpunkt gesendet, wenn keine Callback-Funktion definiert ist und ein Nutzer auf die Schaltfläche „Über Google anmelden“ oder die „ One Tap“-Schaltfläche bzw. die automatische Anmeldung klickt.

Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Optional Beispiel
URL Standardmäßig wird der URI der aktuellen Seite oder der von Ihnen angegebene Wert verwendet.
Ignoriert, wenn data-ux_mode="popup" und data-callback festgelegt sind.
data-login_uri="https://www.example.com/login"

Ihr Anmeldeendpunkt muss POST-Anfragen verarbeiten, die einen credential-Schlüssel mit einem ID-Tokenwert im Text enthalten.

Hier sehen Sie eine Beispielanfrage an Ihren Anmeldeendpunkt:

POST /login HTTP/1.1
Host: www.example.com
Content-Type: application/x-www-form-urlencoded

credential=ID_TOKEN

data-callback

Dieses Attribut ist der Name der JavaScript-Funktion, die das zurückgegebene ID-Token verarbeitet. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Erforderlich, wenn data-login_uri nicht festgelegt ist. data-callback="handleToken"

Möglicherweise wird eines der Attribute data-login_uri und data-callback verwendet. Das hängt von den folgenden Komponenten- und UX-Moduskonfigurationen ab:

  • Das data-login_uri-Attribut ist für den UX-Modus redirect„Über Google anmelden“ erforderlich, wodurch das Attribut data-callback ignoriert wird.

  • Eines dieser beiden Attribute muss für Google One Tap und die Google Log-in-Schaltfläche „popup“ festgelegt werden. Wenn beide festgelegt sind, hat das Attribut data-callback eine höhere Priorität.

JavaScript-Funktionen in einem Namespace werden von der HTML API nicht unterstützt. Verwenden Sie stattdessen eine globale JavaScript-Funktion ohne Namespace. Beispiel: Verwende mylibCallback anstelle von mylib.callback.

data-native_login_uri

Dieses Attribut ist die URL Ihres Endpunkts für die Anmeldedaten für das Passwort. Wenn du entweder das Attribut data-native_login_uri oder das Attribut data-native_callback festlegst, greift die JavaScript-Bibliothek auf den nativen Anmeldeinformationsmanager zurück, wenn keine Google-Sitzung vorhanden ist. Sie dürfen nicht sowohl das Attribut data-native_callback als auch das Attribut data-native_login_uri festlegen. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Optional data-login_uri="https://www.example.com/password_login"

data-native_callback

Dieses Attribut ist der Name der JavaScript-Funktion, die die vom Browser zurückgegebenen Anmeldedaten des Browsers verarbeitet. Wenn Sie entweder das Attribut data-native_login_uri oder das Attribut data-native_callback festlegen, greift die JavaScript-Bibliothek auf den nativen Anmeldeinformationsmanager zurück, wenn keine Google-Sitzung vorhanden ist. Du darfst data-native_callback und data-native_login_uri nicht gleichzeitig setzen. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Optional data-native_callback="handlePasswordCredential"

JavaScript-Funktionen in einem Namespace werden von der HTML API nicht unterstützt. Verwenden Sie stattdessen eine globale JavaScript-Funktion ohne Namespace. Beispiel: Verwende mylibCallback anstelle von mylib.callback.

data-native_id_param

Wenn Sie die Anmeldedaten für den Passwort-Handler an den Endpunkt des Passwort-Anmeldedaten-Handlers senden, können Sie den Parameternamen für das Feld credential.id angeben. Der Standardname ist email. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
URL Optional data-native_id_param="user_id"

data-native_password_param.

Wenn Sie die Anmeldedaten für den Passwort-Anmeldeinformations-Handler senden, können Sie den Parameternamen für den Wert credential.password angeben. Der Standardname ist password. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
URL Optional data-native_password_param="pwd"

data-cancel_on_tap_outside [Abbrechen_bei_Tap_Outside]

Dieses Attribut legt fest, ob die One Tap-Anfrage abgebrochen werden soll, wenn der Nutzer auf eine Stelle außerhalb der Aufforderung klickt. Der Standardwert ist true. Setze zum Deaktivieren den Wert auf false. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
boolean Optional data-cancel_on_tap_outside="false"

data-prompt_parent_id

Dieses Attribut legt die DOM-ID des Containerelements fest. Ist die Option nicht festgelegt, wird rechts oben im Fenster die One-Touch-Aufforderung angezeigt. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Optional data-prompt_parent_id="parent_id"

Dieses Attribut überspringt One Tap, wenn das angegebene Cookie einen nicht leeren Wert hat. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Optional data-skip_prompt_cookie="SID"

Data One

Dieses Attribut ist ein zufälliger String, der vom ID-Token verwendet wird, um Wiederholungsangriffe zu verhindern. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Optional data-nonce="biaqbm70g23"

Die Nonce-Länge ist auf die von Ihrer Umgebung unterstützte maximale JWT-Größe sowie auf individuelle Browser- und Server-HTTP-Größenbeschränkungen beschränkt.

Datenkontext

Durch dieses Attribut werden der Text des Titels und der Nachrichten geändert, die in der One Tap-Aufforderung angezeigt werden. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Optional data-context="use"

In der folgenden Tabelle sind die verfügbaren Kontexte und ihre Beschreibungen aufgeführt:

Kontext
signin Mit Google anmelden
signup Mit Google anmelden
use Mit Google verwenden

Daten-Moment_Rückruf

Dieses Attribut ist der Name der Funktion des Listeners für die Statusmeldung der Aufforderung. Weitere Informationen finden Sie unter dem Datentyp PromptMomentNotification. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Optional data-moment_callback="logMomentNotification"

JavaScript-Funktionen in einem Namespace werden von der HTML API nicht unterstützt. Verwenden Sie stattdessen eine globale JavaScript-Funktion ohne Namespace. Beispiel: Verwende mylibCallback anstelle von mylib.callback.

Wenn Sie One Tap in einer übergeordneten Domain und deren Subdomains anzeigen müssen, übergeben Sie die übergeordnete Domain an dieses Attribut, damit ein einzelnes freigegebenes Cookie verwendet wird. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Optional data-state_cookie_domain="example.com"

Daten-UX-Modus

Mit diesem Attribut legen Sie den Ablauf der Nutzererfahrung fest, die von der Schaltfläche „Über Google anmelden“ verwendet wird. Der Standardwert ist popup. Dieses Attribut hat keinen Einfluss auf die One Tap-UX. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Optional data-ux_mode="redirect"

In der folgenden Tabelle sind die verfügbaren UX-Modi und ihre Beschreibungen aufgeführt.

UX-Modus
popup Führt den UX-Ablauf in einem Pop-up-Fenster durch.
redirect Führt den UX-Ablauf über eine vollständige Seitenweiterleitung durch.

data-allowed_parent_origin

Die Ursprünge, in denen der Zwischen-iFrame eingebettet werden darf. One Tap wird im Zwischen-iFrame-Modus ausgeführt, wenn dieses Attribut vorhanden ist. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
String oder String-Array Optional data-allowed_parent_origin="https://example.com"

In der folgenden Tabelle sind die unterstützten Werttypen und ihre Beschreibungen aufgeführt.

Werttypen
string Ein einzelner Domain-URI. "https://beispiel.de"
string array Eine Liste von durch Kommas getrennten Domain-URIs. "https://news.beispiel.de,https://local.example.com"

Wenn der Wert des data-allowed_parent_origin-Attributs ungültig ist, schlägt die One-Tap-Initialisierung des Zwischen-iFrame-Modus fehl.

Präfixe mit Platzhaltern werden ebenfalls unterstützt. Beispielsweise gleicht "https://*.example.com" example.com und seine Subdomains auf allen Ebenen ab (z. B. news.example.com, login.news.example.com). Hinweise zu Platzhaltern:

  • Musterstrings dürfen nicht nur aus einem Platzhalter und einer Top-Level-Domain bestehen. Beispiel: https://*.com und https://*.co.uk sind ungültig. Wie oben beschrieben stimmt "https://*.example.com" mit example.com und den zugehörigen Subdomains überein. Du kannst auch eine durch Kommas getrennte Liste verwenden, um zwei verschiedene Domains darzustellen. Beispiel: "https://example1.com,https://*.example2.com" entspricht den Domains example1.com, example2.com und Subdomains von example2.com
  • Platzhalterdomains müssen mit einem sicheren „https://“-Schema beginnen. "*.example.com" gilt als ungültig.

data-intermediate_iframe_close_callback

Überschreibt das Standard-iFrame-Verhalten, wenn Nutzer in der One Tap-Benutzeroberfläche durch Tippen auf die Schaltfläche 'X' die Schaltfläche manuell schließen. Standardmäßig wird der Zwischen-iFrame sofort aus dem DOM entfernt.

Das Feld data-intermediate_iframe_close_callback ist nur im Zwischen-iFrame-Modus wirksam. Und es hat nur Auswirkungen auf den Zwischen-iFrame und nicht auf den One Tap-iFrame. Die UI von One Tap wird entfernt, bevor der Callback aufgerufen wird.

Typ Erforderlich Beispiel
Funktion Optional data-intermediate_iframe_close_callback="logBeforeClose"

JavaScript-Funktionen in einem Namespace werden von der HTML API nicht unterstützt. Verwenden Sie stattdessen eine globale JavaScript-Funktion ohne Namespace. Beispiel: Verwende mylibCallback anstelle von mylib.callback.

data-itp_support

Mit diesem Feld wird festgelegt, ob das aktualisierte One Tap-UX-Feature in Browsern aktiviert werden sollte, die Intelligent Tracking Prevention (ITP) unterstützen. Der Standardwert ist false. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
boolean Optional data-itp_support="true"

Element mit der Klasse &g_id_signin"

Wenn du g_id_signin einem class-Attribut eines Elements hinzufügst, wird es als Schaltfläche „Über Google anmelden“ gerendert.

Sie können mehrere Schaltflächen „Über Google anmelden“ auf derselben Seite rendern. Jede Schaltfläche kann eigene Einstellungen haben. Die Einstellungen werden durch die folgenden Datenattribute definiert.

Attribute für visuelle Daten

In der folgenden Tabelle sind die Attribute für visuelle Daten und ihre Beschreibungen aufgeführt:

Attribut
data-type Schaltflächentyp: Symbol oder Standardschaltfläche
data-theme Das Schaltflächendesign. Beispiel: Fill_blue oderfilled_black.
data-size Die Größe der Schaltfläche Zum Beispiel klein oder groß.
data-text Schaltflächentext Beispiel: „Mit Google anmelden“ oder „Mit Google registrieren“
data-shape Die Form der Schaltfläche Beispiel: Rechteckig oder kreisförmig.
data-logo_alignment Die Ausrichtung des Google-Logos: links oder zentriert.
data-width Die Breite der Schaltfläche in Pixeln
data-locale Der Text der Schaltfläche wird in der Sprache gerendert, die in diesem Attribut festgelegt ist.

Attributtypen

Die folgenden Abschnitte enthalten Details zu den einzelnen Attributen und ein Beispiel.

Datentyp

Der Schaltflächentyp Der Standardwert ist standard. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Ja data-type="icon"

In der folgenden Tabelle sind die verfügbaren Schaltflächentypen und ihre Beschreibungen aufgeführt:

Typ
standard Eine Schaltfläche mit Text oder personalisierten Informationen:
icon Eine Symbolschaltfläche ohne Text:

data-theme

Das Schaltflächendesign. Der Standardwert ist outline. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Optional data-theme="filled_blue"

In der folgenden Tabelle sind die verfügbaren Designs und ihre Beschreibungen aufgeführt:

Theme
outline Standardmäßiges Schaltflächendesign:
Eine Standardschaltfläche mit weißem Hintergrund Eine Symbolschaltfläche mit weißem Hintergrund Personalisierte Schaltfläche mit weißem Hintergrund
filled_blue Das blau gefüllte Schaltflächendesign:
Eine Standardschaltfläche mit blauem Hintergrund Eine Symbolschaltfläche mit blauem Hintergrund Personalisierte Schaltfläche mit blauem Hintergrund
filled_black So funktioniert das Schaltflächendesign:
Eine Standardschaltfläche mit schwarzem Hintergrund Eine Symbolschaltfläche mit schwarzem Hintergrund Personalisierte Schaltfläche mit schwarzem Hintergrund

data-size

Die Größe der Schaltfläche Der Standardwert ist large. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Optional data-size="small"

In der folgenden Tabelle finden Sie die verfügbaren Größen und ihre Beschreibungen.

Größe
large Eine große Schaltfläche:
Eine große Standardschaltfläche Eine große Symbolschaltfläche Eine große, personalisierte Schaltfläche
medium Mittelgroße Schaltfläche:
Eine mittlere Standardschaltfläche Symbol für mittleres Symbol
small Eine kleine Schaltfläche:
Eine kleine Schaltfläche Eine kleine Symbolschaltfläche

Datentext

Schaltflächentext Der Standardwert ist signin_with. Es gibt keine visuellen Unterschiede bei dem Text von Symbolschaltflächen mit unterschiedlichen data-text-Attributen. Die einzige Ausnahme ist der Text, der auf Bedienungshilfen für den Bildschirm gelesen wird.

Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Optional data-text="signup_with"

Die folgende Tabelle enthält die Texte der Schaltflächen und ihrer Beschreibungen:

Text
signin_with Der Schaltflächentext lautet „Über Google anmelden“:
Eine Standardschaltfläche mit der Bezeichnung &#39;Über Google anmelden&#39; Eine Symbolschaltfläche ohne sichtbaren Text
signup_with Der Schaltflächentext lautet „Bei Google registrieren“:
Eine Standardschaltfläche mit der Bezeichnung &#39;Bei Google registrieren&#39; Eine Symbolschaltfläche ohne sichtbaren Text
continue_with Der Schaltflächentext lautet „Weiter mit Google“:
Eine Standardschaltfläche mit der Bezeichnung &#39;Weiter mit Google&#39; Eine Symbolschaltfläche ohne sichtbaren Text
signin Der Schaltflächentext lautet „Anmelden“:
Eine Standardschaltfläche mit der Bezeichnung &#39;Anmelden&#39; Eine Symbolschaltfläche ohne sichtbaren Text

Datenform

Die Form der Schaltfläche Der Standardwert ist rectangular. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Optional data-shape="rectangular"

In der folgenden Tabelle sind die verfügbaren Formen und ihre Beschreibungen aufgeführt:

Form
rectangular Die rechteckige Schaltfläche Wird für den Schaltflächentyp icon verwendet, ist er mit square identisch.
Eine rechteckige Standardschaltfläche Eine rechteckige Symbolschaltfläche Eine rechteckige personalisierte Schaltfläche
pill Die Pillentaste. Wird dieser Parameter für den Schaltflächentyp icon verwendet, ist er mit circle identisch.
Eine Tablettenform in Standardform Eine Schaltfläche in Form einer runde Schaltfläche Eine personalisierte Schaltfläche mit Pillenform
circle Die kreisförmige Schaltfläche Wird für den Schaltflächentyp standard verwendet, ist er mit pill identisch.
Eine kreisförmige Standardschaltfläche Eine kreisförmige Symbolschaltfläche Eine kreisförmige personalisierte Schaltfläche
square Die quadratische Form. Wird für den Schaltflächentyp standard verwendet, ist er mit rectangular identisch.
Quadratische Standardschaltfläche Eine quadratische Schaltfläche Eine quadratische personalisierte Schaltfläche

Logo: data-alignment

Die Ausrichtung des Google-Logos. Der Standardwert ist left. Dieses Attribut gilt nur für den Schaltflächentyp standard. Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Optional data-logo_alignment="center"

In der folgenden Tabelle sind die verfügbaren Ausrichtungen und ihre Beschreibungen aufgeführt:

Logoausrichtung
left Das Google-Logo wird links ausgerichtet:
Eine Standardschaltfläche mit dem G-Logo auf der linken Seite
center Zentriert das Google-Logo:
Eine Standardschaltfläche mit dem G-Logo in der Mitte

Datenbreite

Die minimale Breite der Schaltfläche in Pixeln. Die maximale Breite beträgt 400 Pixel.

Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Optional data-width=400

Datensprache

Die vordefinierte Sprache des Schaltflächentexts. Wenn sie nicht festgelegt ist, wird die Standardsprache des Browsers oder die Einstellung für die Nutzer der Google-Sitzung verwendet. Daher sehen verschiedene Nutzer möglicherweise verschiedene Versionen von lokalisierten Schaltflächen und möglicherweise mit unterschiedlichen Größen.

Weitere Informationen finden Sie in der folgenden Tabelle:

Typ Erforderlich Beispiel
string Optional data-locale="zh_CN"

Serverseitige Integration

Deine serverseitigen Endpunkte müssen die folgenden HTTP-POST-Anfragen verarbeiten können.

Endpunkt des ID-Token-Handlers

Der ID-Token-Handler-Endpunkt verarbeitet das ID-Token. Je nach Status des entsprechenden Kontos kannst du den Nutzer anmelden und ihn entweder auf eine Registrierungsseite oder auf eine Seite zur Kontoverknüpfung weiterleiten, wo du weitere Informationen erhältst.

Die HTTP-Anfrage POST enthält die folgenden Informationen:

Formatieren Name Beschreibung
Cookie g_csrf_token Ein Zufallsstring, der sich mit jeder Anfrage an den Handler-Endpunkt ändert.
Anfrageparameter g_csrf_token Ein String, der mit dem vorherigen Cookie-Wert identisch ist: g_csrf_token.
Anfrageparameter credential Das ID-Token, das Google ausstellt.
Anfrageparameter select_by Wie die Anmeldedaten ausgewählt werden.

Wenn decodiert ist, sieht das ID-Token so aus:

header
{
  "alg": "RS256",
  "kid": "f05415b13acb9590f70df862765c655f5a7a019e", // JWT signature
  "typ": "JWT"
}
payload
{
  "iss": "https://accounts.google.com", // The JWT's issuer
  "nbf":  161803398874,
  "aud": "314159265-pi.apps.googleusercontent.com", // Your server's client ID
  "sub": "3141592653589793238", // The unique ID of the user's Google Account
  "hd": "gmail.com", // If present, the host domain of the user's GSuite email address
  "email": "elisa.g.beckett@gmail.com", // The user's email address
  "email_verified": true, // true, if Google has verified the email address
  "azp": "314159265-pi.apps.googleusercontent.com",
  "name": "Elisa Beckett",
                            // If present, a URL to user's profile picture
  "picture": "https://lh3.googleusercontent.com/a-/e2718281828459045235360uler",
  "given_name": "Eliza",
  "family_name": "Beckett",
  "iat": 1596474000, // Unix timestamp of the assertion's creation time
  "exp": 1596477600, // Unix timestamp of the assertion's expiration time
  "jti": "abc161803398874def"
}

In der folgenden Tabelle sind die möglichen Werte für das Feld select_by aufgeführt. Mit dem Typ der Schaltfläche, die zusammen mit dem Sitzungs- und Einwilligungsstatus verwendet wird, wird der Wert festgelegt.

  • Der Nutzer hat entweder die Schaltfläche „One Tap“ oder „Über Google anmelden“ gedrückt oder den Modus für die automatische Anmeldung ohne Berührung verwendet.

  • Es wurde eine vorhandene Sitzung gefunden oder der Nutzer hat sich für ein neues Konto in einem Google-Konto angemeldet und angemeldet.

  • Bevor die Anmeldedaten für das ID-Token mit Ihrer App geteilt werden, muss der Nutzer entweder

    • auf „Bestätigen“ geklickt haben, um die Einwilligung zur Weitergabe von Anmeldedaten zu erteilen, oder
    • zuvor ihre Einwilligung gegeben und ein Konto ausgewählt, um ein Google-Konto auszuwählen.

Der Wert dieses Feldes ist auf einen dieser Typen festgelegt.

Wert Beschreibung
auto Automatische Anmeldung eines Nutzers mit einer vorhandenen Sitzung, der zuvor die Einwilligung zur Freigabe von Anmeldedaten erteilt hat.
user Ein Nutzer mit einer vorhandenen Sitzung, der zuvor die Einwilligung erteilt hat, hat die Schaltfläche „One Tap 'Weiter als“ aktiviert, um die Anmeldedaten zu teilen.
user_1tap Ein Nutzer mit einer vorhandenen Sitzung hat die One Tap-Taste 'Weiter als gedrückt und die Einwilligung erteilt und die Anmeldedaten geteilt. Gilt nur für Chrome v75 und höher.
user_2tap Ein Nutzer ohne eine bestehende Sitzung hat die One Tap-Taste 'Weiter als Gilt für Browser, die nicht aus Chromium stammen.
btn Ein Nutzer mit einer vorhandenen Sitzung, der zuvor die Einwilligung erteilt hat, hat auf die Schaltfläche „Über Google anmelden“ geklickt und ein Google-Konto aus &&339;Ein Konto auswählen' ausgewählt, um die Anmeldedaten zu teilen.
btn_confirm Ein Nutzer mit einer vorhandenen Sitzung hat die Schaltfläche „Über Google anmelden“ und die Schaltfläche „Bestätigen“ angeklickt, um Einwilligung zu erteilen und Anmeldedaten freizugeben.
btn_add_session Ein Nutzer ohne eine bestehende Sitzung, der zuvor die Einwilligung erteilt hat, hat auf die Schaltfläche „Über Google anmelden“ geklickt, um ein Google-Konto auszuwählen und Anmeldedaten freizugeben.
btn_confirm_add_session Ein Nutzer ohne vorhandene Sitzung hat zuerst auf die Schaltfläche „Über Google anmelden“ geklickt und damit ein Google-Konto ausgewählt. Anschließend hat er die Schaltfläche „Bestätigen“ angeklickt, um die Einwilligung einzuholen und die Anmeldedaten freizugeben.

Endpunkt des Passwort-Anmeldedaten-Handlers

Der Endpunkt für den Passwort-Anmeldedaten-Handler verarbeitet die Anmeldedaten, die vom nativen Anmeldedatenmanager abgerufen werden.

Die HTTP-Anfrage POST enthält die folgenden Informationen:

Formatieren Name Beschreibung
Cookie g_csrf_token Ein Zufallsstring, der sich mit jeder Anfrage an den Handler-Endpunkt ändert.
Anfrageparameter g_csrf_token Ein String, der mit dem vorherigen Cookie-Wert g_csrf_token übereinstimmt.
Anfrageparameter email Dieses ID-Token, das Google ausstellt.
Anfrageparameter password Wie die Anmeldedaten ausgewählt werden.