Съвети / Google OAuth setup

Как да създадеш Google OAuth Client за Editor.bg — стъпка по стъпка

Това ръководство е за потребители, които искат да свържат Google Search Console и GA4 към SEO Audit в Editor.bg, но не работят всеки ден с Google Cloud. Тук е описано кое откъде се взима, кое къде се попълва и кои стойности не трябва да се бъркат.

Какво ти трябва общо

  • Google OAuth Client ID — взима се от Google Cloud.
  • Google OAuth Client Secret — взима се от Google Cloud.
  • GA4 Property ID — взима се от Google Analytics.
  • Google акаунт, който има достъп до Search Console property и до GA4 property на сайта.

Най-важното преди да започнеш

Client ID не е имейл

Client ID е дълга стойност от вида 1234567890-xxxx.apps.googleusercontent.com. В полето не се пише Gmail адрес.

GA4 Property ID не е Measurement ID

Property ID е число, например 370774318. Measurement ID е от вида G-XXXXXXXXXX и не се използва в това поле.

Използвай отделен клиент за Editor.bg

Не смесвай локални тестове, n8n и production настройка. Най-чисто е да създадеш нов Web application client само за Editor.bg.

Част 1: включи нужните API-та в Google Cloud

  1. Влез в Google Cloud Console и отвори проекта, в който ще създадеш клиента.
  2. Отиди в APIs & Services → Library.
  3. Активирай Google Search Console API.
  4. Активирай Google Analytics Data API.
Без тези API-та OAuth login-ът може да мине, но синхронизациите към Search Console и GA4 няма да работят правилно.

Част 2: създай нов OAuth client

  1. В Google Cloud отвори Google Auth Platform → Clients. В по-стария интерфейс може да е под APIs & Services → Credentials.
  2. Натисни Create credentials или Create client.
  3. Избери OAuth client ID.
  4. Ако Google поиска първо consent/branding screen, попълни името на приложението, support email и contact email, след което се върни към създаването на клиента.
  5. За тип на приложението избери Web application.
  6. За име на клиента можеш да използваш Editor.bg Google SEO Audit.

Част 3: добави правилния redirect URI

В полето Authorized redirect URIs добави точно този адрес:

https://editor.bg/google/oauth/callback
Ако redirect URI-то не съвпада 1:1, Google ще върне грешка от типа redirect_uri_mismatch и свързването няма да мине.

Част 4: къде са Client ID и Client Secret

След като натиснеш Create, Google ще покаже:

  • Client ID
  • Client Secret
Това са двете стойности, които се записват в Profile → Google data connection в Editor.bg.

Част 5: откъде се взима GA4 Property ID

  1. Влез в Google Analytics.
  2. Отиди в Администратор.
  3. Отвори Подробности за собствеността.
  4. Горе вдясно ще видиш ID на собствеността.
Това е числовата стойност, която се записва в проекта като GA4 Property ID. Не записвай Measurement ID от вида G-XXXXXXXXXX.

Част 6: какво попълваш в Editor.bg

В Profile → Google data connection
  • Google OAuth Client ID
  • Google OAuth Client Secret
В конкретния Project → Search data / Google data
  • Свържи Google
  • Избери Search Console property
  • Запиши GA4 Property ID
  • Пусни GSC sync
  • Пусни GA4 sync

Какво да правиш, ако не пазиш стария secret

  • Ако все още имаш достъп до Google Cloud проекта, често можеш да видиш стойностите от съществуващия client.
  • Ако не си сигурен кой клиент е правилният, създай нов OAuth client за Editor.bg.
  • Ако старият secret е споделен в чат, файл или e-mail, приеми го като компрометиран и го подмени.

Бърза проверка преди тест

  • Има ли нов Web application client?
  • Добавен ли е https://editor.bg/google/oauth/callback?
  • Попълнени ли са Client ID и Client Secret в профила?
  • Попълнен ли е правилният GA4 Property ID в проекта?
  • Google акаунтът има ли достъп и до Search Console, и до GA4 property-то?