Google Log-in verwaltet den OAuth 2.0-Vorgang und den Token-Lebenszyklus und vereinfacht so die Einbindung in Google APIs. Ein Nutzer hat jederzeit die Möglichkeit, den Zugriff auf eine Anwendung zu widerrufen.
In diesem Dokument wird die grundlegende Integration von Google Log-in beschrieben.
Anmeldedaten für die Autorisierung erstellen
Jede Anwendung, die OAuth 2.0 für den Zugriff auf Google APIs verwendet, muss Anmeldedaten für die Autorisierung der Anwendung für den OAuth 2.0-Server von Google haben. In den folgenden Schritten wird erläutert, wie Sie Anmeldedaten für Ihr Projekt erstellen. Ihre Anwendungen können dann mit den Anmeldedaten auf APIs zugreifen, die Sie für dieses Projekt aktiviert haben.
- Go to the Credentials page.
- Klicken Sie auf Anmeldedaten erstellen > OAuth-Client-ID.
- Wählen Sie den Anwendungstyp Webanwendung aus.
- Benennen Sie den OAuth 2.0-Client und klicken Sie auf Erstellen.
Notieren Sie sich nach der Konfiguration die erstellte Client-ID. Für die nächsten Schritte benötigen Sie die Client-ID. Es wird auch ein Clientschlüssel erstellt, den Sie aber nur für serverseitige Vorgänge benötigen.
Google Platform Library laden
Du musst die Google Platform-Bibliothek auf deinen Webseiten einfügen, die Google Log-in integrieren.
<script src="https://apis.google.com/js/platform.js" async defer></script>
Client-ID der App angeben
Gib die Client-ID, die du für deine App erstellt hast, in der Google Developers Console mit dem Metaelement google-signin-client_id
an.
<meta name="google-signin-client_id" content="YOUR_CLIENT_ID.apps.googleusercontent.com">
Google Log-in-Schaltfläche hinzufügen
Am einfachsten kannst du deiner Website eine Google Log-in-Schaltfläche hinzufügen, indem du eine automatisch gerenderte Anmeldeschaltfläche verwendest. Mit nur wenigen Codezeilen können Sie eine Schaltfläche hinzufügen, die automatisch den entsprechenden Text, das Logo und die Farben für den Anmeldestatus des Nutzers und die angeforderten Bereiche konfiguriert.
Wenn du eine Google Log-in-Schaltfläche erstellen möchtest, die die Standardeinstellungen verwendet, füge deiner Anmeldeseite ein div
-Element mit der Klasse g-signin2
hinzu:
<div class="g-signin2" data-onsuccess="onSignIn"></div>
Profilinformationen abrufen
Nachdem Sie sich bei Google mit den Standardbereichen angemeldet haben, können Sie auf die Google-ID, den Namen, die Profil-URL und die E-Mail-Adresse des Nutzers zugreifen.
Mit der Methode getBasicProfile()
können Sie Profilinformationen für einen Nutzer abrufen.
function onSignIn(googleUser) {
var profile = googleUser.getBasicProfile();
console.log('ID: ' + profile.getId()); // Do not send to your backend! Use an ID token instead.
console.log('Name: ' + profile.getName());
console.log('Image URL: ' + profile.getImageUrl());
console.log('Email: ' + profile.getEmail()); // This is null if the 'email' scope is not present.
}
Nutzer abmelden
Sie können Nutzern die Möglichkeit geben, sich von Ihrer App abzumelden, ohne sich bei Google abzumelden, indem Sie eine Abmeldeschaltfläche oder einen Link zu Ihrer Website hinzufügen. Hängen Sie zum Erstellen eines Abmeldelinks eine Funktion an, die die Methode GoogleAuth.signOut()
an das Ereignis onclick
des Links aufruft.
<a href="#" onclick="signOut();">Sign out</a>
<script>
function signOut() {
var auth2 = gapi.auth2.getAuthInstance();
auth2.signOut().then(function () {
console.log('User signed out.');
});
}
</script>