Skip to content
adplane

How Adplane uses the Google Ads API

Adplane connects your Google Ads accounts to Claude so you can work with them in plain language. It reads your reporting data when you ask a question, and it can make changes only when you explicitly ask for that specific change. We request a single Ads scope and act only on the accounts you already manage.

What we read

  • List accounts. The Google Ads accounts your Google sign-in can already reach, so you can pick one to work with.
  • Report fields. The set of valid fields for a report, so queries are built correctly rather than guessed.
  • Run a report. Campaign, ad group, keyword, and search-term performance for one account: cost, clicks, impressions, conversions, and the date range you asked about.
  • Run a query. A raw GAQL query against one account, for questions the structured report does not cover. GAQL is a read-only query language and cannot change anything.

What we can change, and only when you ask

Adplane also exposes campaign-management tools. Every change they make happens at your explicit request, inside your own conversation, on an account you named. Three rules bound all of them:

  • Everything starts paused. Campaigns, ad groups, keywords, and ads that Adplane creates are always created paused. Nothing it creates can serve or spend.
  • One path to spending. A single update tool is the only way to enable anything. Nothing spends unless you explicitly turn it on, and enabling is called out plainly when it happens.
  • Removal is narrow and guarded. The one removal tool works on campaigns only, and only on campaigns that have never spent. Anything with a spending history can be paused but never removed by Adplane, and no status change can ever remove anything.

The write tools also add negative keywords, which only restrict where ads show and cannot spend. Every change is read back from the API and reported as Google stored it.

What we never do

  • We never act on our own. Adplane makes no scheduled, automated, or background changes. Every write is a direct response to something you asked for.
  • We never reach other accounts. Every read and every change is scoped to a single account you already have access to. There are no cross-customer operations.
  • We never pool your data. Your Google Ads data is not aggregated with anyone else's, resold, or redistributed.

What happens to the data

Report results are returned into your own Claude conversation, at your request, for your own accounts. We cache results briefly so a follow-up question in the same conversation does not re-query the API, and we record how many operations you run for metering. We do not store the content of your queries or their results beyond that cache.

Adplane requests one Ads scope, https://www.googleapis.com/auth/adwords, plus the standard sign-in scopes used only to identify you. You can revoke access at any time from your Google Account, or disconnect from the accounts page, which deletes your refresh token immediately. Our use of Google user data complies with the Google API Services User Data Policy, including the Limited Use requirements. See our privacy policy for what we store and how to delete it.