Um bei Google Lesezugriff anzufordern, benötigt SaaSMaestro einen OAuth-Client aus einem Google-Cloud-Projekt. Jeder Workspace hat einen eigenen Client, der im Tab „Datenverbindungen“ eingerichtet wird; ein Google-Cloud-Projekt kann alle bedienen.
Prüfen Sie zuerst: Öffnen Sie im Workspace Einstellungen → Datenverbindungen und sehen Sie sich das Feld „Google-OAuth-Einrichtung“ an. Steht dort „Konfiguriert“ oder „In .env konfiguriert“, ist alles erledigt und Sie können direkt Ihr Google-Konto verbinden.
Wer das tun kann
Inhaber und Admins des Workspace, den Sie gerade ansehen. Da die Änderung beeinflusst, wie sich alle im Workspace bei Google anmelden, werden Sie erneut nach Ihrem Passwort gefragt, wenn Sie es in den letzten 15 Minuten nicht eingegeben haben.
Schritt für Schritt
Klicken Sie im Tab „Datenverbindungen“ des Workspace auf das Feld „Google-OAuth-Einrichtung“. Das Einrichtungsfenster führt durch dieselben fünf Schritte:
- Erstellen oder wählen Sie ein Google-Cloud-Projekt. Jedes Projekt ist geeignet.
- Aktivieren Sie drei APIs: Google Analytics Admin API, Google Analytics Data API und Google Search Console API.
- Konfigurieren Sie den Zustimmungsbildschirm. Wählen Sie „Intern“, wenn alle Google-Konten, die Sie verbinden werden, zu Ihrem eigenen Google Workspace gehören. Andernfalls wählen Sie „Extern“ und fügen, solange sich die App im Testmodus befindet, jedes Google-Konto, das Sie verbinden werden, als Testnutzer hinzu.
- Erstellen Sie einen OAuth-Client vom Typ „Webanwendung“ und fügen Sie den im Einrichtungsfenster angezeigten Weiterleitungs-URI hinzu. Verwenden Sie die Schaltfläche „Kopieren“, damit er exakt übereinstimmt.
- Fügen Sie die Client-Zugangsdaten ein: Client ID und Client secret, und klicken Sie dann auf „Zugangsdaten speichern“.
Die Einrichtung testen
- Zugangsdaten testen prüft Client ID und Secret bei Google, ohne sich anzumelden.
- Anmeldung testen führt die vollständige Google-Anmeldung durch und verbindet das Konto bei Erfolg mit Ihrem Workspace.
Das Client secret wird verschlüsselt gespeichert. Um nur die Client ID zu ändern, lassen Sie das Secret-Feld leer; das gespeicherte Secret bleibt dann erhalten. „Gespeicherte Zugangsdaten entfernen“ löscht sie.
Häufige Fehler
| Google meldet | Was zu tun ist |
|---|---|
redirect_uri_mismatch | Der Weiterleitungs-URI in Google Cloud stimmt nicht exakt überein. Kopieren Sie ihn erneut aus dem Einrichtungsfenster, einschließlich http bzw. https und eines eventuellen Pfads am Ende. |
access_denied | Der Zustimmungsbildschirm ist auf „Extern“ gesetzt und im Testmodus, und dieses Google-Konto ist kein Testnutzer. Fügen Sie es bei den Testnutzern des Zustimmungsbildschirms hinzu. |
| API nicht aktiviert | Eine der drei APIs ist im Projekt nicht aktiviert. Aktivieren Sie sie, warten Sie eine Minute und versuchen Sie es erneut. |
invalid_client | Client ID oder Secret sind falsch, oder der Client wurde gelöscht. Fügen Sie neue Zugangsdaten ein. |
Weiter: Google-Konten verbinden.