Google Console Konfiguration

Bevor das Google Workspace Modul mit Google-Diensten kommunizieren kann, müssen Sie ein Google Cloud-Projekt erstellen, die erforderlichen APIs aktivieren und OAuth-Zugangsdaten generieren. Diese Anleitung führt Sie durch jeden Schritt.

Schritt 1: Ein Google Cloud-Projekt erstellen

1. Gehen Sie zur Google API Console.
2. Klicken Sie in der oberen Navigationsleiste auf Projekt auswählen und dann auf Neues Projekt.
3. Geben Sie einen Projektnamen ein (z. B. „Concord CRM Integration").
4. Klicken Sie auf Erstellen und warten Sie, bis das Projekt bereitgestellt ist.
5. Stellen Sie sicher, dass das neue Projekt im Projekt-Dropdown ausgewählt ist.

info

Wenn Sie bereits ein Google Cloud-Projekt haben, das Sie wiederverwenden möchten, wählen Sie es aus der Projektliste aus, anstatt ein neues zu erstellen.

Schritt 2: Erforderliche APIs aktivieren

Aktivieren Sie mit dem ausgewählten Projekt die folgenden APIs:

1. Navigieren Sie zu APIs & Dienste → Bibliothek.
2. Suchen Sie nach jeder API und aktivieren Sie sie einzeln:
   • Google Drive API
   • Google Docs API
   • Google Sheets API
   • Google Slides API

Für jede API:

1. Klicken Sie auf den API-Namen in den Suchergebnissen.
2. Klicken Sie auf Aktivieren.
3. Warten Sie auf die Bestätigung, bevor Sie mit der nächsten fortfahren.

warnung

Alle vier APIs müssen aktiviert sein, damit das Modul korrekt funktioniert. Wenn eine API fehlt, ist der entsprechende Google-Dienst nicht über das CRM erreichbar.

Schritt 3: OAuth-Zustimmungsbildschirm konfigurieren

1. Navigieren Sie zu APIs & Dienste → OAuth-Zustimmungsbildschirm.
2. Wählen Sie den Benutzertyp:
   • Extern -- Empfohlen für die meisten Einrichtungen. Ermöglicht jedem Google-Konto die Autorisierung.
   • Intern -- Nur für Google Workspace (kostenpflichtige) Konten verfügbar. Beschränkt den Zugriff auf Benutzer innerhalb Ihrer Organisation.
3. Klicken Sie auf Erstellen.
4. Füllen Sie die erforderlichen Felder aus:
   • App-Name -- Ein Name, den Benutzer während der Autorisierung sehen (z. B. „Concord CRM").
   • Support-E-Mail des Benutzers -- Ihre Support-E-Mail-Adresse.
   • Kontaktinformationen des Entwicklers -- Ihre E-Mail-Adresse.
5. Klicken Sie auf Speichern und fortfahren durch die Schritte Bereiche und Testbenutzer (für die Grundeinrichtung sind keine Änderungen erforderlich).
6. Klicken Sie im Zusammenfassungs-Tab auf Zurück zum Dashboard.

Veröffentlichungsstatus

Status	HTTPS erforderlich	Hinweise
Test	Nein	Beschränkt auf 100 Testbenutzer; zeigt eine zusätzliche Zustimmungswarnung
Produktion	Ja	Für alle Benutzer verfügbar; Ihre Website muss HTTPS verwenden

tipp

Für die Ersteinrichtung und Tests behalten Sie die App im Test-Modus. Sobald Sie überprüft haben, dass alles funktioniert, wechseln Sie zu Produktion für ein nahtloses Autorisierungserlebnis.

Schritt 4: OAuth-Zugangsdaten erstellen

1. Navigieren Sie zu APIs & Dienste → Zugangsdaten.
2. Klicken Sie auf Zugangsdaten erstellen → OAuth-Client-ID.
3. Wählen Sie Webanwendung als Anwendungstyp.
4. Geben Sie einen Namen für die Zugangsdaten ein (z. B. „Concord CRM OAuth").
5. Fügen Sie unter Autorisierte Weiterleitungs-URIs Folgendes hinzu:

https://yourdomain.com/google-workspace/callback

Ersetzen Sie yourdomain.com durch die tatsächliche Domain, auf der Ihr Concord CRM installiert ist.

6. Klicken Sie auf Erstellen.
7. Ein Dialog zeigt Ihre Client-ID und Ihr Client-Secret an. Kopieren Sie beide Werte.

warnung

Die Weiterleitungs-URI muss exakt mit der Installations-URL Ihres Concord CRM übereinstimmen, einschließlich Protokoll (HTTPS) und Pfad. Eine falsche Weiterleitungs-URI führt dazu, dass die Autorisierung fehlschlägt.

Schritt 5: Mit Concord CRM verbinden

1. Melden Sie sich als Administrator in Ihrem Concord CRM an.
2. Navigieren Sie zu den Einstellungen des Google Workspace Moduls.
3. Fügen Sie die Client-ID und das Client-Secret aus dem vorherigen Schritt ein.
4. Klicken Sie auf Speichern & Autorisieren.
5. Ein Google-Zustimmungsbildschirm wird angezeigt. Wählen Sie Ihr Google-Konto und erteilen Sie die angeforderten Berechtigungen.
6. Sie werden zu Concord CRM zurückgeleitet. Der Verbindungsstatus sollte nun Autorisiert anzeigen.

info

Wenn Ihre Google Cloud-App im Test-Modus ist, sehen Sie während der Autorisierung einen zusätzlichen Warnbildschirm. Klicken Sie auf Fortfahren, um fortzufahren. Diese Warnung erscheint nicht im Produktionsmodus.

Fehlerbehebung

Problem	Lösung
„Error 400: redirect_uri_mismatch"	Überprüfen Sie, ob die Weiterleitungs-URI in Google Cloud exakt mit Ihrer CRM-URL übereinstimmt
Autorisierung schlägt stillschweigend fehl	Stellen Sie sicher, dass alle vier APIs im Google Cloud-Projekt aktiviert sind
„Zugriff blockiert: App nicht verifiziert"	Wechseln Sie zum Produktionsmodus oder fügen Sie Ihr Konto als Testbenutzer hinzu
Verbindung bricht nach einiger Zeit ab	Erneut aus den Moduleinstellungen autorisieren; Token-Aktualisierungseinstellungen prüfen

Sicherheitsempfehlungen

• Beschränken Sie OAuth-Zugangsdaten auf Ihre spezifische Domain mithilfe autorisierter Weiterleitungs-URIs.
• Verwenden Sie HTTPS für Ihre Concord CRM-Installation, um OAuth-Tokens bei der Übertragung zu schützen.
• Überprüfen Sie den API-Zugriff regelmäßig in der Google Cloud Console, um sicherzustellen, dass keine unnötigen Berechtigungen erteilt sind.
• Wechseln Sie Zugangsdaten, wenn Sie vermuten, dass diese kompromittiert wurden.

Support

Wenn Sie Hilfe bei der Konfiguration Ihres Google Cloud-Projekts benötigen, besuchen Sie den Themesic Support-Ticketbereich für Unterstützung.