Mit Google verbinden

Zugangsschlüssel bei Google holen, in die App einfügen und die Website wählen. So kommen Search Console und Analytics 4 in die App.

Die Oberfläche der App ist auf Türkisch und Englisch verfügbar. Die Sprache lässt sich unter Ayarlar → Görünüm → Dil ändern. Diese Anleitung nennt jede Schaltfläche und jeden Bildschirmnamen auf Türkisch, mit der deutschen Bedeutung in Klammern.

Am Ende verbindet sich die App in Ihrem Namen mit Google und liest die Daten Ihrer Website. Dafür holen Sie einmalig einen „Google-Zugangsschlüssel“ bei Google. Das dauert etwa zehn Minuten und muss nur einmal geschehen. Am Ende der Seite steht ein kürzerer Weg, das Dienstkonto, den wir den meisten empfehlen.

Voraussetzungen

Eine in der Search Console bestätigte Website (Property). Ist sie nicht bestätigt, sieht die App sie nicht in der Liste.
Für Analytics 4 mindestens die Berechtigung „Betrachter“ (Görüntüleyen) für diese Property. Das ist optional; die Search Console allein genügt.
Ein Google-Konto. Die Google Cloud Console (Googles Seite für Entwickler) ist kostenlos und verlangt keine Zahlungskarte.
Die geöffnete App. Von dort kopieren Sie die beiden Weiterleitungsadressen (die Adressen, über die Google Sie nach der Freigabe in die App zurückbringt).

Schritte

Öffnen Sie in der App den Bereich Ayarlar → Google (Einstellungen → Google). Sie sehen zwei Adressen. Die eine endet auf /api/gsc/oauth/callback (Search Console), die andere auf /api/ga4/oauth/callback (Analytics). Im Windows-Paket beginnen die Adressen mit http://127.0.0.1:3001, bei Docker mit http://localhost:3001. Notieren Sie beide.
Gehen Sie im Browser zu console.cloud.google.com. Wählen Sie in der Projektauswahl oben Yeni proje (Neues Projekt). Der Name ist beliebig, zum Beispiel „seowatcher“.
Öffnen Sie die Seite API'ler ve Hizmetler → Kitaplık (APIs und Dienste → Bibliothek). Geben Sie in das Suchfeld Google Search Console API ein, klicken Sie darauf und wählen Sie Etkinleştir (Aktivieren). Wenn Sie auch Analytics verbinden, tun Sie dasselbe für die Google Analytics Admin API und die Google Analytics Data API.
Öffnen Sie die Seite API'ler ve Hizmetler → OAuth izin ekranı (APIs und Dienste → OAuth-Zustimmungsbildschirm). Wählen Sie als Nutzertyp Harici (Extern). Als Anwendungsname geben Sie einen beliebigen Namen ein, in die E-Mail-Felder Ihre eigene E-Mail-Adresse. Der Veröffentlichungsstatus kann „Test“ bleiben.
Fügen Sie auf derselben Seite im Abschnitt Test kullanıcıları (Testnutzer) Ihr eigenes Google-Konto hinzu. Google muss nichts zusätzlich genehmigen.
Wählen Sie auf der Seite API'ler ve Hizmetler → Kimlik bilgileri (APIs und Dienste → Anmeldedaten) Kimlik bilgisi oluştur (Anmeldedaten erstellen) und dann OAuth istemci kimliği (OAuth-Client-ID). Das ist Ihr Google-Zugangsschlüssel.
Wählen Sie als Anwendungstyp Web uygulaması (Webanwendung).
Tragen Sie im Abschnitt Yetkilendirilmiş yönlendirme URI'leri (Autorisierte Weiterleitungs-URIs) die beiden Adressen aus Schritt 1 ein. Setzen Sie keinen Schrägstrich ans Ende. Schon ein einziges abweichendes Zeichen löst bei Google den Fehler „redirect_uri_mismatch“ (Adresse stimmt nicht überein) aus.
Klicken Sie auf Oluştur (Erstellen). Google zeigt eine Client-ID und einen geheimen Schlüssel an.
Kehren Sie zur App zurück. Fügen Sie im Bereich Ayarlar → Google im Feld İstemci kimliği (Client-ID) die Kennung ein, die auf .apps.googleusercontent.com endet. Fügen Sie im Feld Gizli anahtar (Geheimer Schlüssel) den Schlüssel ein, der mit GOCSPX- beginnt.
Klicken Sie auf Kaydet (Speichern). Es erscheint die Meldung „Google erişim anahtarı kaydedildi“ (Google-Zugangsschlüssel gespeichert). Ein Neustart ist nicht nötig. Fügen Sie den Schlüssel in das falsche Feld ein, warnt die App: „Kimlik .apps.googleusercontent.com ile bitmeli. Gizli anahtarı değil, istemci kimliğini yapıştırın.“ (Die Kennung muss auf .apps.googleusercontent.com enden. Fügen Sie die Client-ID ein, nicht den geheimen Schlüssel.)
Haben Sie in der App noch kein Projekt, legen Sie zuerst mit Yeni proje (Neues Projekt) eines an. Einzelheiten stehen in der Anleitung Projeler.
Gehen Sie zu Ihrem Projekt: Proje ayarları → Bağlantılar (Projekteinstellungen → Verbindungen). Klicken Sie auf der Karte Google Search Console auf Bağlan (Verbinden).
Wählen Sie auf Googles Zustimmungsbildschirm das Konto, das Sie als Testnutzer hinzugefügt haben, und erlauben Sie den Zugriff. Zurück in der App erscheint die Meldung „Search Console bağlandı“ (Search Console verbunden).
Wählen Sie Ihre Website in der Liste Mülk seç (Property auswählen) und klicken Sie auf Mülkü kaydet (Property speichern). Wählen Sie eine Domain-Property, steht auf der Karte „Alan adı mülkü: tüm alt alan adlarını ve http/https adreslerini kapsar.“ (Domain-Property: umfasst alle Subdomains sowie http- und https-Adressen.)
Für Analytics klicken Sie auf demselben Bildschirm auf der Karte Google Analytics auf Bağlan, erlauben den Zugriff und wählen die Property. Die beiden Verbindungen brauchen getrennte Freigaben; die eine schließt die andere nicht ein.

Der kürzere Weg: das Dienstkonto

Ein Dienstkonto (Hizmet hesabı) ist ein besonderes Konto, das sich an Ihrer Stelle mit Google verbindet. Sie brauchen weder den Zustimmungsbildschirm noch eine Weiterleitungsadresse. Möchten Sie sich in der App stattdessen mit Ihrem eigenen Google-Konto anmelden, folgen Sie dem Weg oben.

Öffnen Sie console.cloud.google.com. Die APIs aus Schritt 3 müssen im selben Cloud-Projekt aktiviert sein. Gehen Sie zur Seite IAM ve Yönetici → Hizmet hesapları (IAM und Verwaltung → Dienstkonten).
Klicken Sie auf Hizmet hesabı oluştur (Dienstkonto erstellen). Geben Sie einen Namen ein. Überspringen Sie die Schritte zu den Rollen und erstellen Sie das Konto.
Öffnen Sie in der Zeile des Kontos den Reiter Anahtarlar (Schlüssel). Wählen Sie Anahtar ekle → Yeni anahtar oluştur (Schlüssel hinzufügen → Neuen Schlüssel erstellen).
Wählen Sie als Schlüsseltyp JSON und klicken Sie auf Oluştur (Erstellen). Eine Datei wird auf Ihren Computer heruntergeladen.
Öffnen Sie in der App den Bereich Ayarlar → Hizmet hesabı (Einstellungen → Dienstkonto). Öffnen Sie die heruntergeladene Datei mit dem Editor (Notepad), fügen Sie den gesamten Inhalt in das Feld ein und speichern Sie. Der Bildschirm zeigt die E-Mail-Adresse des Kontos an.
Wählen Sie in der Search Console Ayarlar → Kullanıcılar ve izinler → Kullanıcı ekle (Einstellungen → Nutzer und Berechtigungen → Nutzer hinzufügen). Geben Sie diese E-Mail-Adresse ein und wählen Sie als Berechtigung Tam (Voll).
Wenn Sie Analytics nutzen, öffnen Sie in Google Analytics bei der Property Yönetici → Erişim yönetimi (Verwaltung → Zugriffsverwaltung). Fügen Sie dieselbe E-Mail-Adresse mit der Berechtigung Görüntüleyen (Betrachter) hinzu.

Ist ein Dienstkonto gespeichert, verwendet die App es. Die Zeile „Şu an kullanılan“ (Aktuell in Verwendung) auf dem Bildschirm Ayarlar (Einstellungen) zeigt, welche Variante gerade aktiv ist.

Kontrolle

Auf den Karten unter Proje ayarları → Bağlantılar muss das Kennzeichen Bağlı (Verbunden) stehen.
Die vier Zahlenkarten auf dem Bildschirm Panel (Übersicht) sollten sich in wenigen Sekunden füllen. Bei einer neuen Website können die Zahlen noch bei null stehen. Das ist kein Verbindungsfehler.
Das Kennzeichen im Bereich Ayarlar → Google sollte Kayıtlı (Gespeichert) anzeigen.

Häufige Fragen

Wo wird der geheime Schlüssel gespeichert? In der Datenbank auf diesem Computer, verschlüsselt. Der Schlüssel dafür ist die Datei instance-secret (unter Windows im Datenordner, bei Docker im Datenspeicher). Er wird nicht an den Browser gesendet.

Kann ich denselben Zugangsschlüssel in mehreren Projekten verwenden? Ja. Ein Schlüssel pro Installation genügt; jedes Projekt wählt seine eigene Property.

Nach einigen Tagen ist die Verbindung abgebrochen. Bei Apps im Status „Test“ kann Google die Freigabe auf sieben Tage begrenzen. Die Karte meldet „Bağlantının süresi doldu“ (Die Verbindung ist abgelaufen). Ein Klick auf Yeniden bağlan (Neu verbinden) genügt. Dauerhaft beheben Sie das, indem Sie den Zustimmungsbildschirm auf „Üretim“ (Produktion) stellen oder auf das Dienstkonto wechseln.

Welche Berechtigungen verlangt die App? Für die Search Console nur Lesen (webmasters.readonly), für Analytics nur Lesen (analytics.readonly). Die App kann bei Google nichts ändern.

Wenn etwas nicht klappt

Google meldet „redirect_uri_mismatch“. Die Weiterleitungsadresse in der Cloud Console ist nicht Zeichen für Zeichen dieselbe wie in der App. Nutzen Sie die Kopierschaltfläche auf dem Bildschirm Ayarlar. Schon http statt https, 127.0.0.1 statt localhost oder ein Schrägstrich am Ende lösen den Fehler aus.
Es erscheint die Warnung „Google erişim anahtarı eksik“ (Google-Zugangsschlüssel fehlt). Schritt 10 und 11 wurden übersprungen oder das Speichern ist fehlgeschlagen. Auf dem Bildschirm Ayarlar muss das Kennzeichen Kayıtlı stehen.
Google meldet „access_denied“. Das Konto, mit dem Sie sich angemeldet haben, steht nicht in der Liste der Testnutzer auf dem Zustimmungsbildschirm. Fügen Sie das Konto der Liste hinzu oder wählen Sie das richtige Konto.
Die Property-Liste ist leer. Dieses Konto hat keine bestätigte Website in der Search Console und keine Berechtigung in Analytics. Bestätigen Sie zuerst die Website.
Es erscheint „Bağlantısı tamamlanmadı“ (Verbindung nicht abgeschlossen) mit „state_mismatch“. Sie haben den Zustimmungsbildschirm in zwei Reitern geöffnet oder länger als zehn Minuten gewartet. Versuchen Sie es von vorn in einem einzigen Reiter. Sind die Cookies des Browsers (kleine Datendateien) ausgeschaltet, schalten Sie sie ein.
Es erscheint „Google hesabı zaten bağlı“ (Das Google-Konto ist bereits verbunden). Das Konto war schon mit einem anderen Eintrag verbunden. Entfernen Sie den alten Eintrag über Hesabı kaldır (Konto entfernen) in der Property-Auswahl und verbinden Sie neu.
Nach einem Update sind die Verbindungen getrennt. Der Verschlüsselungsschlüssel hat sich geändert (bei Docker wurde BETTER_AUTH_SECRET hinzugefügt, oder der Datenspeicher wurde neu erstellt). Klicken Sie auf den Karten auf Yeniden bağlan.

Zuletzt aktualisiert: 24 Oktober 2026. Fehler entdeckt? Auf GitHub melden.