> ## Documentation Index
> Fetch the complete documentation index at: https://docs.boxd.sh/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

```bash theme={"theme":"github-dark"}
run auth googleads
run auth googleads --scope team    # shared with the organization
```

Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one.

## Use it

```bash theme={"theme":"github-dark"}
run googleads          # common commands
run googleads --all    # every command
```

```ts theme={"theme":"github-dark"}
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.                                                                            |

<Accordion title="All 22 tools" icon="list">
  | 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.                                                                            |
</Accordion>

[Open Google Ads in the console →](https://app.boxd.sh/integrations/detail/googleads)
