Eigenen Google-Zugang einrichten

Damit rankion.ai deine Daten aus der Google Search Console, aus Google Analytics 4 und aus deinem Google-Unternehmensprofil lesen darf, braucht dein Team einen eigenen Google-Zugang: einen OAuth-Client in deinem Google-Cloud-Projekt. Du legst ihn einmal an und trägst zwei Werte bei rankion.ai ein, die Client-ID und den Clientschlüssel. Danach läuft jede Verbindung deines Teams über dein eigenes Google-Projekt.

Einrichten dürfen den Zugang nur Eigentümer und Administratoren deines Teams. Alle anderen Mitglieder sehen, ob ein Zugang hinterlegt ist.

Bevor du anfängst

Öffne in rankion.ai die Seite Google-Integration (/integrations/google). Oben steht der Bereich Google-Zugang deines Teams mit zwei autorisierten Weiterleitungs-URIs:

Nimm die Adressen immer von dieser Seite, mit dem Knopf Kopieren. Google vergleicht sie Zeichen für Zeichen; ein fehlender oder zusätzlicher Schrägstrich am Ende führt zu »Fehler 400: redirect_uri_mismatch«.

Schritt 1: Google-Cloud-Projekt anlegen

1. Öffne die Google Cloud Console und melde dich mit dem Google-Konto an, dem deine Search Console und dein Analytics gehören.
2. Wähle oben in der Projektauswahl Neues Projekt, gib ihm einen Namen (zum Beispiel »rankion«) und lege es an.
3. Achte darauf, dass das neue Projekt oben ausgewählt ist, bevor du weitermachst.

Schritt 2: APIs aktivieren

Unter APIs und Dienste → Bibliothek suchst du jede der folgenden APIs und klickst auf Aktivieren:

• Google Search Console API
• Google Analytics Data API
• Google Analytics Admin API

Nur wenn du Bewertungen aus deinem Unternehmensprofil abrufen willst, zusätzlich:

• My Business Account Management API
• My Business Business Information API
• Google My Business API

Die Unternehmensprofil-APIs schaltet Google erst nach einem Antrag frei. Den stellst du über das Formular, das Google in der Dokumentation der Business Profile APIs verlinkt.

Schritt 3: Zustimmungsbildschirm einrichten

1. Öffne APIs und Dienste → OAuth-Zustimmungsbildschirm (in neueren Konsolen heißt der Bereich Google Auth Platform).
2. Wähle als Zielgruppe Extern. Gehört dein Google-Konto zu einer Google-Workspace-Organisation und nutzen nur Personen daraus rankion.ai, reicht Intern.
3. Trage einen App-Namen, deine Support-E-Mail-Adresse und eine Kontaktadresse ein.
4. Füge unter Datenzugriff (oder Bereiche) diese Bereiche hinzu: .../auth/webmasters.readonly, .../auth/analytics.readonly und, nur für Bewertungen, .../auth/business.manage.
5. Setze den Status der App auf In Produktion. Im Status Testen dürfen sich nur eingetragene Testnutzer anmelden, und Google lässt die Freigabe nach sieben Tagen ablaufen. Die Verbindung in rankion.ai fällt dann aus.

Für die lesenden Bereiche verlangt Google bei einer externen App unter Umständen eine Überprüfung. Bis sie abgeschlossen ist, zeigt Google beim Verbinden einen Hinweis »Diese App wurde nicht überprüft«; über Erweitert kannst du für dein eigenes Konto trotzdem fortfahren.

Schritt 4: OAuth-Client anlegen

1. Öffne APIs und Dienste → Anmeldedaten (oder Google Auth Platform → Clients).
2. Wähle Anmeldedaten erstellen → OAuth-Client-ID.
3. Anwendungstyp: Webanwendung. Der Name ist frei wählbar.
4. Unter Autorisierte Weiterleitungs-URIs trägst du beide Adressen aus rankion.ai ein, jede als eigene Zeile.
5. Speichere. Google zeigt dir jetzt die Client-ID (endet auf .apps.googleusercontent.com) und den Clientschlüssel (beginnt meist mit GOCSPX-).

Schritt 5: Werte in rankion.ai eintragen

1. Zurück auf Google-Integration in rankion.ai: trage im Bereich Google-Zugang deines Teams die Client-ID und den Clientschlüssel ein.
2. Klicke auf Zugang speichern. Der Status wechselt auf Eigener Zugang aktiv.
3. Klicke jetzt auf Mit Google verbinden. Ab hier läuft die Anmeldung über dein Google-Projekt.

Der Clientschlüssel wird verschlüsselt gespeichert und nie wieder angezeigt, auch nicht teilweise. Willst du nur die Client-ID behalten und den Schlüssel erneuern, trägst du den neuen Schlüssel ein. Lässt du das Feld leer, bleibt der gespeicherte Schlüssel.

Was mit bestehenden Verbindungen passiert

• Verbindungen, die dein Team vor dem eigenen Zugang hergestellt hat, laufen unverändert weiter.
• Trägst du eine neue Client-ID ein oder entfernst du den Zugang, müssen Verbindungen, die über den alten Zugang liefen, neu verbunden werden. Google bindet jede Freigabe an genau den Client, über den sie erteilt wurde. Solche Verbindungen erscheinen danach als »abgelaufen«; ein Klick auf Weiteres Konto mit demselben Google-Konto stellt sie wieder her.

Häufige Fehler

Verwandt: Erste Schritte · API: Google-Integrations-API (GET /v1/google/oauth-client zeigt den Stand, ohne den Schlüssel).