Google Ads for AI agents
Agents read Google Ads at once. Changes and sends are held for a person's approval by default.
About Google Ads
Google Ads, is an online advertising platform developed by Google, where advertisers bid to display brief advertisements, service offerings, product listings, and videos to web users.
What an agent can do in Google Ads
Every Google Ads action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Google Ads without asking first. 12 actions.
- Generate Keyword IdeasGenerate keyword ideas and planning metrics from exactly one seed form.
- Get Conversion Action Tag SnippetsRetrieve provider-generated website or call conversion tag snippets after creating a conversion action. Markup is returned exactly as Google provides it.
- Get Required Google Ads ReportRun a prominent, bounded Google Ads report template for Customer, Campaign, Ad, Keyword, Search Term, Dynamic Search Ads Search Term, or Bidding Strategy. Official required columns are always selected
- List Accessible CustomersList Google Ads customer resource names directly accessible to the authenticated OAuth user. Google determines the complete result from the OAuth credentials and ignores customer_id and login-customer
- List Sub AccountsList direct child/sub-accounts under a Google Ads manager (MCC) account. Use this before account-scoped read or mutate calls when a user needs to choose which child account to target. The returned cus
- Search Google Ads FieldsSearch the Google Ads v23 field metadata catalog with GAQL.
- Search Stream GAQLExecute a Google Ads Query Language (GAQL) query and aggregate every streamed response batch in order. For very large reports, select only needed fields and use WHERE and LIMIT because action response
- Get Campaign By IdGetCampaignById Tool returns details of a campaign in Google Ads. Requires an active Google Ads OAuth connection with the correct customer_id configured; missing or mismatched customer_id will cause e
- Get campaign by nameQueries Google Ads via SQL to retrieve a campaign by its exact name. Requires an active Google Ads connection with valid customer_id and appropriate OAuth scopes.
- Get conversion ingestion statusRetrieve one Data Manager ingestion status snapshot. SUCCESS, FAILED, and PARTIAL_SUCCESS are terminal. PROCESSING and REQUEST_STATUS_UNKNOWN are not. The caller owns the documented backoff loop.
- Get customer listsGetCustomerLists Tool lists all customer lists (audience/remarketing lists) in Google Ads. These are user segments for targeting, not Google Ads accounts — list IDs are distinct from account IDs. When
- List data manager conversion actionsList conversion actions usable as Google Ads Data Manager destinations. Returns numeric destination IDs, true owning accounts, action types, and availability; defaults to enabled offline and enhanced-
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 27 actions.
- Batch Mutate Google Ads ResourcesCreate, update, remove, or act on supported Google Ads resource types in one request. With partial_failure=false (the default), all operations are atomic and execute only if every operation is valid.
- Create Callout AssetCreate an immutable account asset containing a validated callout. Associate the returned resource using Mutate Customer Assets with field_type CALLOUT. Cleanup removes that association; Google does no
- Mutate Ad Group AdsCreate, update, or remove ads in Google Ads ad groups, including responsive search ads. Use this after creating campaigns, budgets, ad groups, and keywords so the ad group has creative that can serve.
- Mutate Ad Group AssetsCreate, update, or remove links between assets and ad groups. Use this after creating assets to attach sitelinks, callouts, snippets, images, and other asset types at ad group level.
- Mutate Ad Group Bid ModifiersCreate, update, or remove ad group bid modifiers, such as device bid adjustments or hotel-specific bid modifier criteria.
- Mutate Ad Group CriteriaCreate, update, or remove criteria attached to a Google Ads ad group in a single batch request. Supports keywords (positive and negative), audience targeting (user lists, custom audiences, combined au
- Mutate Ad GroupsCreate, update, or remove ad groups within Google Ads campaigns. Supports batch operations with multiple ad group changes in a single request. Use when you need to manage ad groups programmatically, s
- Mutate Asset Group AssetsCreate, update, or remove links between assets and Performance Max asset groups. Use this after creating compatible assets and an asset group.
- Mutate AssetsCreate or update supported Google Ads assets such as sitelinks, structured snippets, text assets, lead forms, promotions, calls, price assets, and media assets. Use Create Callout Asset for validated
- Mutate Asset SetsCreate, update, or remove Google Ads asset sets, which group assets for feeds, locations, and other campaign uses. Link assets to a set separately with an AssetSetAsset mutation, and attach sets to ca
- Mutate Bidding StrategiesCreate, update, or remove portfolio bidding strategies such as Target CPA, Target ROAS, Target Spend, Maximize Conversions, Maximize Conversion Value, and Target Impression Share.
- Mutate Campaign AssetsCreate, update, or remove links between assets and campaigns. Use this after creating assets to attach sitelinks, callouts, snippets, and other asset types at campaign level.
Show all 27
- Mutate Campaign BudgetsCreate, update, or remove Google Ads campaign budgets. Use this before creating campaigns because campaign creation requires an existing campaign_budget resource name.
- Mutate Campaign CriteriaCreate, update, or remove campaign-level targeting criteria such as locations, languages, campaign-level negative keywords, devices, schedules, audiences, and IP exclusions.
- Mutate Campaign LabelsCreate or remove relationships between campaigns and labels. Use this after creating labels to organize campaigns for filtering and reporting.
- Mutate CampaignsCreate, update, or remove Google Ads campaigns in batch. Supports multiple operations (create, update, remove) in a single request. Use when managing campaign lifecycle, applying bulk changes, or auto
- Mutate Campaigns V2Create, update, or remove Google Ads campaigns in batch. Supports multiple operations (create, update, remove) in a single request. Use when managing campaign lifecycle, applying bulk changes, or auto
- Mutate Conversion ActionsCreate, update, or remove Google Ads conversion actions for conversion tracking configuration. This manages Google Ads conversion action resources; installing website/app tags remains outside this act
- Mutate Custom AudiencesCreate, update, or remove Google Ads custom audiences used to reach users by interests, searches, visited URLs, place categories, or installed apps.
- Mutate Customer AssetsCreate or remove customer-level asset associations. Removal irreversibly removes the current association; recreate it to restore the link. Use this after creating assets to attach callouts, sitelinks,
- Mutate LabelsCreate, update, or remove Google Ads labels. Pair this with campaign label mutations to organize campaigns and support filtering.
- Mutate Portfolio Bidding StrategiesCreate, edit, or remove typed Target CPA and Target ROAS portfolio strategies. Attach with Mutate Campaigns, read with Get Required Google Ads Report, and transition all campaigns before removal. Budg
- Mutate Shared CriteriaCreate or remove criteria in a Google Ads shared set, such as negative keywords or excluded placements shared across campaigns.
- Mutate Shared SetsCreate, update, or remove Google Ads shared sets used to group shared criteria, such as negative keyword lists, for reuse across campaigns.
- Add or remove to customer listAdds or removes contacts from a Google Ads customer list (UserList/audience/remarketing list), not a Google Ads customer account. Note: It takes 6 to 12 hours for changes to be reflected in the custom
- Create customer listCreates a Google Ads customer list (UserList/audience/remarketing list), not a Google Ads customer account. Note: Requires an authenticated Google Ads connection with customer_id configured. Email-bas
- Ingest conversion eventsValidate or submit a bounded Google Ads conversion-event batch. Set validate_only=true for a no-ingestion check. False starts irreversible asynchronous processing and returns a request ID for later st
Changes wait in Needs you
Changes and sends in Google Ads are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Related connectors
Google Ads questions
Can an agent change data in Google Ads on its own?
Not by default. Changes and sends in Google Ads are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Google Ads?
This connector lists 12 read actions. Reads run at once, without waiting for approval.
How does Google Ads connect?
It connects with OAuth 2.0. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.