Merge API Documentation

Authentication: OAuth. See Magic Link for the runtime auth flow, or Application credentials to bring your own OAuth app.

Sample use cases

Run a GAQL report on campaign spend and conversions for the last 30 days.
Pause every ad group whose cost per conversion exceeds $150.
Add negative keywords to the Brand campaign based on last week’s search terms report.

list_ad_groups

List ad groups for a customer with optional filtering by campaign and status

get_ad_group

Get details of a specific ad group

create_ad_group

Create a new ad group within a campaign

update_ad_group

Update an ad group. Set status=REMOVED to delete

list_ads

List ads for a customer with optional filtering by ad group and status

get_ad

Get details of a specific ad

create_ad

Create a Responsive Search Ad

update_ad

Update an ad (status only)

list_campaign_budgets

List campaign budgets for a customer

create_campaign_budget

Create a new campaign budget

list_campaigns

List campaigns for a customer with optional filtering by status, channel type, and name

get_campaign

Get details of a specific campaign

create_campaign

Create a new campaign

update_campaign

Update a campaign. Set status=REMOVED to delete

list_accessible_customers

List all Google Ads customer account IDs accessible with the current credentials

get_customer

Get details of a specific Google Ads customer account (ID, name, currency, timezone)

list_keywords

List keywords (ad group criteria) for a customer with optional filtering by ad group and status

create_keywords

Create one or more keywords in an ad group

update_keyword

Update a keyword. Use list_keywords to find criterion_id

remove_keyword

Permanently remove a keyword from an ad group

search_google_ads

Run a custom GAQL (Google Ads Query Language) query to retrieve arbitrary resource data and metrics