Aby prosić Google o dostęp tylko do odczytu, SaaSMaestro potrzebuje klienta OAuth z projektu Google Cloud. Każdy obszar roboczy ma własnego klienta, konfigurowanego na jego karcie Połączenia danych; jeden projekt Google Cloud może obsługiwać je wszystkie.
Najpierw sprawdź: otwórz Ustawienia → Połączenia danych obszaru roboczego i spójrz na pole „Konfiguracja Google OAuth”. Jeśli widnieje tam „Skonfigurowano” lub „Skonfigurowano w .env”, konfiguracja jest już gotowa i możesz od razu połączyć konto Google.
Kto może to zrobić
Właściciele i administratorzy przeglądanego obszaru roboczego. Ponieważ zmiana wpływa na sposób logowania do Google wszystkich osób w obszarze roboczym, zostaniesz poproszony(-a) o ponowne podanie hasła, jeśli nie wpisywałeś(-aś) go w ciągu ostatnich 15 minut.
Krok po kroku
Kliknij pole „Konfiguracja Google OAuth” na karcie Połączenia danych obszaru roboczego. Okno konfiguracji przeprowadzi Cię przez te same pięć kroków:
- Utwórz lub wybierz projekt Google Cloud. Wystarczy dowolny projekt.
- Włącz trzy API: Google Analytics Admin API, Google Analytics Data API i Google Search Console API.
- Skonfiguruj ekran zgody. Wybierz „Wewnętrzny”, jeśli wszystkie konta Google, które połączysz, należą do Twojego Google Workspace. W przeciwnym razie wybierz „Zewnętrzny” i, dopóki aplikacja jest w trybie testowym, dodaj każde konto Google, które połączysz, jako użytkownika testowego.
- Utwórz klienta OAuth typu „Aplikacja internetowa” i dodaj identyfikator URI przekierowania widoczny w oknie konfiguracji. Użyj przycisku Kopiuj, aby był dokładnie taki sam.
- Wklej dane uwierzytelniające klienta: Client ID i Client secret, a następnie kliknij „Zapisz dane uwierzytelniające”.
Testowanie konfiguracji
- Testuj dane uwierzytelniające sprawdza Client ID i Client secret w Google bez logowania.
- Testuj logowanie przeprowadza pełne logowanie przez Google i, jeśli się powiedzie, łączy to konto z Twoim obszarem roboczym.
Client secret jest przechowywany w postaci zaszyfrowanej. Aby zmienić tylko Client ID, pozostaw pole Client secret puste, a zapisany klucz zostanie zachowany. „Usuń zapisane dane uwierzytelniające” usuwa je.
Częste błędy
| Komunikat Google | Co zrobić |
|---|---|
redirect_uri_mismatch | Identyfikator URI przekierowania w Google Cloud nie jest dokładnie taki sam. Skopiuj go ponownie z okna konfiguracji, łącznie z http lub https i ewentualną końcową ścieżką. |
access_denied | Ekran zgody ma typ Zewnętrzny i jest w trybie testowym, a to konto Google nie jest użytkownikiem testowym. Dodaj je do użytkowników testowych ekranu zgody. |
| API nie jest włączone | Jedno z trzech API nie jest włączone w projekcie. Włącz je, odczekaj minutę i spróbuj ponownie. |
invalid_client | Client ID lub Client secret jest nieprawidłowy albo klient został usunięty. Wklej nowe dane uwierzytelniające. |
Dalej: Łączenie kont Google.