Skip to content
All docs

Connect Google Analytics, Search Console, Gmail and Drive

One Google sign-in covers analytics, Search Console, Gmail and Drive. Then pick a GA4 property and a Search Console site for each site.

Updated View as Markdown
On this page· 6 sections

Steps

1. Grant Google access for the workspace

  1. Go to Integrations.
  2. Click Connect on any of the four Google connectors. They all share the same grant, so one click covers all four. In a team workspace, only an admin can connect or disconnect Google.
  3. Sign in with the Google account that owns your analytics data and the address you'd like AEBOT to send from.
  4. On the consent screen you'll see four scopes. Approve them all to enable the full feature set:
    • analytics.readonly: GA4 traffic data. Read-only.
    • webmasters.readonly: Search Console queries and clicks. Read-only.
    • gmail.send: compose and send mail from your address. Cannot read existing mail, drafts, or labels.
    • drive.file: create new Google Docs or Markdown files in your Drive. Restricted by Google to files AuditAE itself created, so we can't see anything else in your Drive.

Connected before we shipped Gmail and Drive? You'll see a Reconnect banner on Integrations. One click re-grants the missing scopes without affecting your saved GA4 and Search Console picks.

2. Pick a GA4 property and a Search Console site for each site

  1. Open the site from Sites.
  2. Open the site's Settings (gear icon) → Connections.
  3. Pick a GA4 property and a Search Console site from the dropdowns.
  4. Click Save selection. Real data shows on the site's Traffic → Search & analytics tab on next load, and the overview's status bar adds a Search Console clicks chip that links there.

Repeat for each site. Each one can point at its own GA4 property if you track several brands. When your Google account has a Search Console property that is exactly the site (the domain property, or https:// at the root with or without www), AuditAE links it for you when you connect Google, add the site, or an agent first queries it; subfolder properties stay your pick. Gmail and Drive don't need this step; they apply to whatever site or report AEBOT is working with at the time.

How the connection works

One Google connection unlocks four capabilities: read analytics, read Search Console, send mail from your address, and save reports to Drive. They all share a single OAuth grant: you approve every scope on Google's consent screen up front and can disconnect everything in one click later.

Setup has two layers: a one-time workspace-level OAuth grant, then (for GA4 and Search Console only) a per-site property pick. Gmail and Drive are workspace-wide, with no per-site setup.

The same connection powers the GA4 and Search Console tools for AI agents (query_google_analytics, query_search_console, inspect_url and get_ai_referral_traffic), so there's no Google Cloud project to set up. The two report tools cost 1¢ per 100 rows returned, rounded up, with a 1¢ minimum per call (a 1,000-row Search Console pull is 10¢); inspect_url is 1¢ per URL and get_ai_referral_traffic 1¢ per call, and a call that errors is free. The dashboard's Traffic tab and AEBOT read the same data free. find_search_opportunities turns it into a ranked list of the pages worth working on (15¢ per site per day). See Connect Claude, ChatGPT or Cursor, the Search Console MCP page and the Google Analytics MCP page.

Action scopes: abilities and risks

Two of the four scopes let AEBOT take real actions in your Google account. Both are narrow on purpose, but the consequences are real: sent mail can't be unsent, and a Drive doc inherits whatever sharing rules you put on its parent folder. AEBOT always confirms recipients and content in chat before calling either tool.

Gmail (gmail.send)

  • Can: compose, send, CC and BCC mail (plain text or HTML). The message's From: is your Google address, so recipients see your name and email.
  • Cannot: read your inbox, search threads, see drafts, modify labels, or view sent mail beyond the message AEBOT just sent.
  • Risks to know: sent mail is final; there is no "undo" from our side. AEBOT shows the recipient list and full body before pressing send and waits for an explicit yes. Treat the first send as a test and CC yourself.

Drive (drive.file)

  • Can: create new Google Docs or .md files in your Drive, including reports AEBOT writes, optionally inside a specific folder you name.
  • Cannot: see, read, edit, list, or delete any file it didn't create. drive.file is the most restricted Drive scope Google offers, and Google enforces the boundary, not us.
  • Risks to know: a saved report inherits the sharing rules of its parent folder. New files default to private (only your Google account can see them); if you ask AEBOT to put one inside a folder shared with your team, the team sees it.

Both action scopes can be revoked instantly with the Disconnect button on Integrations. We call Google's revoke endpoint and drop the refresh token, after which any future tool call refuses until you reconnect.

What we store

  • A refresh token at the workspace level, used to mint short-lived access tokens for each API call. Encrypted at rest.
  • Your Google email (Integrations shows it next to the Google connectors) and the granted scope list.
  • For GA4 and Search Console: the selected property and site identifiers on each site.
  • For Gmail: nothing per message. Sent mail lives in your Sent folder, not ours.
  • For Drive: nothing per file. Saved reports live in your Drive only.

Disconnecting calls Google's revoke endpoint and deletes the workspace token. Reconnecting replaces it with a fresh grant.

Troubleshooting

  • "Google access was revoked": Google stopped accepting AuditAE's access (for example, access was removed in your Google account or the password changed), so GA4, Search Console, Gmail and Drive are paused. Click Reconnect Google on Integrations.
  • "API has not been used in this project": this is on our side, not yours. Email support@auditae.app and we'll enable it.
  • Is a page indexed, and does Google see its schema? Ask AEBOT, or call inspect_url from an AI client. It runs Search Console's URL Inspection on one page (or up to 20 in one call) and returns whether it's indexed (and why not), robots.txt and noindex state, the last crawl, the canonical Google picked against the one the page declares, and the rich results Google detected with their errors. It's free in AEBOT; from an AI client it's 1¢ per URL inspected. It uses the same webmasters.readonly scope, so there's nothing new to approve. It shows Google's last crawl, not the live page: after a fix goes live, use Request indexing in Search Console to have Google recrawl it. Search Console allows about 2,000 inspections a day per property.
  • "Not enough data" on the Traffic chart: GA4 needs a couple of days of recorded sessions before the daily series fills in.
  • Empty top query in Search Console: Search Console data lags about two days, and a query needs a minimum number of clicks before it appears.

What to do next

  • Share the same traffic, search and conversion data with a client: Share a client portal.
  • Ask AEBOT about your traffic, or have it email or save a report: Using AEBOT.

Try it in AuditAE

Open Integrations

Still stuck? Signed in, ask AEBOT in Documentation mode (free). Or email support@auditae.app.