Troubleshooting

🔐 Google authentication failed

Common causes:

• Google security interstitial (“Verify it’s you”)
• wrong credentials
• CAPTCHA / 2FA

What the service does:

• retries once
• clears browser-data/<username> before retry

If that does not help:

• run in non-headless mode and inspect the UI via VNC
• increase GSC_* timeouts
• update selectors / texts used by commands

🚫 Domain not found / no access

check_domain_safety can raise an exception if the account has no access to the property.

Verify:

• the domain/property is added to GSC for that account
• you are using a root domain where required (for DomainAccountMapping)

🧩 UI changes / selectors broken

Commands rely on UI texts and selectors. If Google changes the UI, selectors may need updates.

📭 Callback not delivered

Check:

• callback_url is set
• Celery worker executes send_callback_task
• callback endpoint availability and logs