#Google-Konfiguration

This feature is provided by the commercial plugin «E-Mail-Verwaltung», please purchase to use

#Voraussetzungen

Damit Benutzer ihre Google Mail-Konten später mit NocoBase verbinden können, muss NocoBase auf einem Server bereitgestellt werden, der Zugriff auf Google-Dienste hat. Das Backend wird die Google API aufrufen.

#Konto registrieren

1. Öffnen Sie https://console.cloud.google.com/welcome, um zu Google Cloud zu gelangen.
2. Beim ersten Besuch müssen Sie den Nutzungsbedingungen zustimmen.

#App erstellen

1. Klicken Sie oben auf "Select a project".

2. Klicken Sie im Pop-up-Fenster auf die Schaltfläche "NEW PROJECT".

3. Füllen Sie die Projektinformationen aus.

4. Nachdem das Projekt erstellt wurde, wählen Sie es aus.

#Gmail API aktivieren

1. Klicken Sie auf die Schaltfläche "APIs & Services".

2. Wechseln Sie zum Dashboard "APIs & Services".

3. Suchen Sie nach "mail".

4. Klicken Sie auf die Schaltfläche "ENABLE", um die Gmail API zu aktivieren.

#OAuth-Zustimmungsbildschirm konfigurieren

1. Klicken Sie links auf das Menü "OAuth consent screen".

2. Wählen Sie "External".

3. Füllen Sie die Projektinformationen aus (diese werden später auf der Autorisierungsseite angezeigt) und klicken Sie auf Speichern.

4. Füllen Sie die "Developer contact information" aus und klicken Sie auf Weiter.

5. Klicken Sie auf Weiter.

6. Fügen Sie Testbenutzer hinzu, um die App vor der Veröffentlichung zu testen.

7. Klicken Sie auf Weiter.

8. Überprüfen Sie die Übersichtsinformationen und kehren Sie zum Dashboard zurück.

#Anmeldeinformationen (Credentials) erstellen

1. Klicken Sie links auf das Menü "Credentials".

2. Klicken Sie auf die Schaltfläche "CREATE CREDENTIALS" und wählen Sie "OAuth client ID".

3. Wählen Sie "Web application".

4. Füllen Sie die Anwendungsinformationen aus.

5. Geben Sie die endgültige Bereitstellungsdomäne des Projekts ein (das hier gezeigte Beispiel ist eine NocoBase-Testadresse).

6. Fügen Sie die autorisierte Weiterleitungs-URI hinzu. Sie muss Domäne + "/admin/settings/mail/oauth2" lauten. Beispiel: https://pr-1-mail.test.nocobase.com/admin/settings/mail/oauth2

7. Klicken Sie auf Erstellen, um die OAuth-Informationen anzuzeigen.

8. Kopieren Sie die Client-ID und das Client-Geheimnis und fügen Sie diese auf der E-Mail-Konfigurationsseite ein.

9. Klicken Sie auf Speichern, um die Konfiguration abzuschließen.

#App veröffentlichen

Nachdem der oben beschriebene Prozess abgeschlossen und Funktionen wie die Autorisierung von Testbenutzern und der E-Mail-Versand getestet wurden, können Sie die App veröffentlichen.

1. Klicken Sie auf das Menü "OAuth consent screen".

2. Klicken Sie auf die Schaltfläche "EDIT APP" und anschließend unten auf die Schaltfläche "SAVE AND CONTINUE".

3. Klicken Sie auf die Schaltfläche "ADD OR REMOVE SCOPES", um die Benutzerberechtigungsbereiche auszuwählen.

4. Suchen Sie nach "Gmail API" und aktivieren Sie dann "Gmail API" (vergewissern Sie sich, dass der Scope-Wert die Gmail API mit "https://mail.google.com/" ist).

5. Klicken Sie unten auf die Schaltfläche "UPDATE", um zu speichern.

6. Klicken Sie unten auf jeder Seite auf die Schaltfläche "SAVE AND CONTINUE" und schließlich auf die Schaltfläche "BACK TO DASHBOARD", um zur Dashboard-Seite zurückzukehren.

7. Klicken Sie auf die Schaltfläche "PUBLISH APP". Es erscheint eine Bestätigungsseite, auf der die für die Veröffentlichung erforderlichen Informationen aufgeführt sind. Klicken Sie anschließend auf die Schaltfläche "CONFIRM".

8. Kehren Sie zur Konsolenseite zurück. Dort sehen Sie, dass der Veröffentlichungsstatus "In production" ist.

9. Klicken Sie auf die Schaltfläche "PREPARE FOR VERIFICATION", füllen Sie die erforderlichen Informationen aus und klicken Sie auf die Schaltfläche "SAVE AND CONTINUE" (die Daten im Bild dienen nur als Beispiel).

10. Füllen Sie die weiteren notwendigen Informationen aus (die Daten im Bild dienen nur als Beispiel).

11. Klicken Sie auf die Schaltfläche "SAVE AND CONTINUE".

12. Klicken Sie auf die Schaltfläche "SUBMIT FOR VERIFICATION", um die Verifizierung einzureichen.

13. Warten Sie auf das Genehmigungsergebnis.

14. Solange die Genehmigung noch aussteht, können Benutzer auf den unsicheren Link klicken, um sich zu autorisieren und anzumelden.