Połączenie z Google Search Console
Bez podłączonego konta GSC moduły Radar Widoczności i Dziennik SEO są puste - wszystkie ich dane pochodzą z GSC. Reszta aplikacji (monitoring HTTP, SSL, DNS, audyt on-page, bezpieczeństwo) działa bez tej integracji.
Wymagania
- Konto Google z dostępem do Google Search Console.
- W GSC ta sama domena, którą dodałeś do RankVoyager, musi być zweryfikowana (jako Domain Property albo URL Prefix).
- Twoje konto Google musi mieć rolę co najmniej Restricted user dla tej property w GSC.
Jeśli zarządzasz wieloma stronami z różnych kont Google - możesz w każdym momencie zalogować się ponownie z innym kontem. Token OAuth jest pamiętany dla bieżącej sesji aplikacji.
Autoryzacja
Wejdź w zakładkę Radar
Otwórz dowolną stronę z Floty, przejdź do zakładki Radar. Jeśli GSC nie jest podłączone, zobaczysz przycisk Zaloguj przez Google.
Wybierz konto Google
Google otworzy standardowy ekran wyboru konta. Wybierz to, które ma dostęp do GSC dla tej domeny.
Zatwierdź zakres uprawnień
Aplikacja żąda jednego zakresu: odczyt danych Search Console (webmasters.readonly). Nie modyfikujemy niczego w twoim GSC - tylko pobieramy dane analityczne. Możesz to zweryfikować na ekranie zgody Google.
Wybierz właściwość
Jeśli twoje konto Google ma dostęp do wielu właściwości w GSC - aplikacja pokaże listę i pozwoli wybrać tę, która odpowiada dodanej domenie. Wybierz wariant z największą ilością danych (zazwyczaj https://, nie http://, i ten bez www jeśli twoja strona nie używa subdomeny www).
Pierwsza synchronizacja
Pierwsze pobranie danych z GSC trwa kilkanaście sekund do paru minut (zależnie od historii). Po zakończeniu Radar i Dziennik SEO pokazują wartości. Tabela top fraz wypełnia się od razu, mini-wykres historii pozycji potrzebuje 7+ dni danych.
Co dokładnie pobieramy z GSC
| Endpoint GSC | Co | Jak często |
|---|---|---|
searchanalytics.query | top frazy, kliknięcia, wyświetlenia, CTR, pozycje | co 3 h (Pro) / co 24 h (Free, Basic) |
sites.list | lista zweryfikowanych properties | raz przy podłączeniu, refresh przy ponownej autoryzacji |
To wszystko. Nie pobieramy raportów pokrycia (Coverage), Sitemap, Mobile Usability, ani danych z Search Console Insights.
Token i jego wygaśnięcie
Google wydaje token OAuth ważny przez 1 godzinę. Aplikacja używa standardowego refresh tokena - w tle odświeża ważność, nie musisz nic robić. Wyjątek: jeśli zalogujesz się z innej przeglądarki / urządzenia, sesja GSC w starej przeglądarce wygaśnie i przy najbliższym wejściu w Radar zobaczysz komunikat Sesja Google wygasła. Klik Połącz ponownie z Google i jesteś z powrotem.
Częste problemy
“Ta domena nie jest zweryfikowana w Twoim Google Search Console” - twoje konto Google nie ma dostępu do property dla tej domeny. Sprawdź czy property istnieje w GSC i czy używasz właściwego konta Google.
“Nie udało się pobrać danych z Google Search Console” - najczęściej przejściowy błąd API. Spróbuj ponownie za parę minut. Jeśli się powtarza - sprawdź ograniczenia kwoty (GSC ma globalne dzienne limity, nie nakładane przez RankVoyager).
Radar wypełnia się tylko częściowo - niektóre domeny mają mało ruchu organicznego, GSC nie ma o nich danych do pokazania. To nie błąd, tylko brak materiału.
Odłączenie GSC
W Konfiguracji → Konto kliknij Odłącz Google. Aplikacja odpina token i usuwa lokalny cache danych GSC. Nie cofa to twojej zgody na poziomie Google - żeby cofnąć ją całkowicie, wejdź na myaccount.google.com/permissions i usuń RankVoyager z listy.