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. googleads · 22 tools · no triggers

Connect it

run auth googleads
run auth googleads --scope team    # shared with the organization

Or from the Integrations page in the console. See Connections for personal versus shared, and who may remove one.

Use it

run googleads          # common commands
run googleads --all    # every command

import { googleads } from "@boxd/run";

Common tools

Tool	What it does
`list-accessible-customers`	List Google Ads customer resource names directly accessible to the authenticated user.
`list-sub-accounts`	List direct child/sub-accounts under a Google Ads manager (MCC) account.
`mutate-ad-group-ads`	Create, update, or remove ads in Google Ads ad groups, including responsive search ads.
`mutate-ad-group-assets`	Create, update, or remove links between assets and ad groups.
`mutate-ad-group-bid-modifiers`	Create, update, or remove ad group bid modifiers, such as device bid adjustments or hotel-specific bid modifier criteria.
`mutate-ad-group-criteria`	Create, update, or remove criteria attached to a Google Ads ad group in a single batch request.
`mutate-ad-groups`	Create, update, or remove ad groups within Google Ads campaigns.
`mutate-assets`	Create or update Google Ads assets such as sitelinks, callouts, structured snippets, text assets, lead forms, promotions, calls, price assets, and media assets.
`mutate-bidding-strategies`	Create, update, or remove portfolio bidding strategies such as Target CPA, Target ROAS, Target Spend, Maximize Conversions, Maximize Conversion…
`mutate-campaign-assets`	Create, update, or remove links between assets and campaigns.
`mutate-campaign-budgets`	Create, update, or remove Google Ads campaign budgets. Use this before creating campaigns because campaign creation requires an existing campaign_budget resource name.
`mutate-campaign-criteria`	Create, update, or remove campaign-level targeting criteria such as locations, languages, campaign-level negative keywords, devices, schedules…
`mutate-campaign-labels`	Create or remove relationships between campaigns and labels.
`mutate-campaigns`	Create, update, or remove Google Ads campaigns in batch. Supports multiple operations (create, update, remove) in a single request.
`mutate-conversion-actions`	Create, update, or remove Google Ads conversion actions for conversion tracking configuration.
`mutate-labels`	Create, update, or remove Google Ads labels. Pair this with campaign label mutations to organize campaigns and support filtering.
`search-stream-gaql`	Execute a Google Ads Query Language (GAQL) query and stream all results in a single response.

All 22 tools

Tool	What it does
`add-or-remove-to-customer-list`	Adds or removes contacts from a Google Ads customer list (UserList/audience/remarketing list), not a Google Ads customer account.
`create-customer-list`	Creates a Google Ads customer list (UserList/audience/remarketing list), not a Google Ads customer account.
`get-campaign-by-id`	GetCampaignById Tool returns details of a campaign in Google Ads.
`get-campaign-by-name`	Queries Google Ads via SQL to retrieve a campaign by its exact name.
`get-customer-lists`	GetCustomerLists Tool lists all customer lists (audience/remarketing lists) in Google Ads.
`list-accessible-customers`	List Google Ads customer resource names directly accessible to the authenticated user.
`list-sub-accounts`	List direct child/sub-accounts under a Google Ads manager (MCC) account.
`mutate-ad-group-ads`	Create, update, or remove ads in Google Ads ad groups, including responsive search ads.
`mutate-ad-group-assets`	Create, update, or remove links between assets and ad groups.
`mutate-ad-group-bid-modifiers`	Create, update, or remove ad group bid modifiers, such as device bid adjustments or hotel-specific bid modifier criteria.
`mutate-ad-group-criteria`	Create, update, or remove criteria attached to a Google Ads ad group in a single batch request.
`mutate-ad-groups`	Create, update, or remove ad groups within Google Ads campaigns.
`mutate-assets`	Create or update Google Ads assets such as sitelinks, callouts, structured snippets, text assets, lead forms, promotions, calls, price assets, and media assets.
`mutate-bidding-strategies`	Create, update, or remove portfolio bidding strategies such as Target CPA, Target ROAS, Target Spend, Maximize Conversions, Maximize Conversion…
`mutate-campaign-assets`	Create, update, or remove links between assets and campaigns.
`mutate-campaign-budgets`	Create, update, or remove Google Ads campaign budgets. Use this before creating campaigns because campaign creation requires an existing campaign_budget resource name.
`mutate-campaign-criteria`	Create, update, or remove campaign-level targeting criteria such as locations, languages, campaign-level negative keywords, devices, schedules…
`mutate-campaign-labels`	Create or remove relationships between campaigns and labels.
`mutate-campaigns`	Create, update, or remove Google Ads campaigns in batch. Supports multiple operations (create, update, remove) in a single request.
`mutate-conversion-actions`	Create, update, or remove Google Ads conversion actions for conversion tracking configuration.
`mutate-labels`	Create, update, or remove Google Ads labels. Pair this with campaign label mutations to organize campaigns and support filtering.
`search-stream-gaql`	Execute a Google Ads Query Language (GAQL) query and stream all results in a single response.

Open Google Ads in the console →

Getting started

Guides

Integrations & automations

Use cases

References

Connect it

Use it

Common tools

​Connect it

​Use it

​Common tools

Connect it

Use it

Common tools