> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Google Ads

**Authentication:** OAuth. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-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.

## Available Tools

#### 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