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

# Google Ads

> The 31 adside commands for Google Ads.

See [Using commands](https://docs.adside.ai/cli/commands.md) for how flags, JSON input, paging and confirmations work. Run `adside google-ads --help` to see what your installed version has.

## google-ads accessible-customers

### google-ads accessible-customers list

List the Google Ads customer account this workspace is connected to.

Beta: this command may still change.

```bash theme={null}
adside google-ads accessible-customers list
```

## google-ads ad-groups

### google-ads ad-groups list

List ad groups for a campaign with bids, status, and rotation settings.

Beta: this command may still change.

```bash theme={null}
adside google-ads ad-groups list --campaign-id <id> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--campaign-id` (required) | `<id>` | |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--status` | `ENABLED\|PAUSED\|REMOVED` | |
| `--limit` | `<number>=100` | |

## google-ads ads

### google-ads ads list

List ads in an ad group with responsive search/display ad details including headlines, descriptions, and ad strength.

Beta: this command may still change.

```bash theme={null}
adside google-ads ads list --ad-group-id <id> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-group-id` (required) | `<id>` | |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--status` | `ENABLED\|PAUSED\|REMOVED` | |
| `--limit` | `<number>=100` | |

## google-ads asset-group-assets

### google-ads asset-group-assets list

List the assets linked to one Performance Max asset group, including each exact AssetGroupAsset resource name, field type, status, asset ID and image dimensions.

Beta: this command may still change.

```bash theme={null}
adside google-ads asset-group-assets list --asset-group-id <id> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--asset-group-id` (required) | `<id>` | |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--field-type` | `HEADLINE\|LONG_HEADLINE\|DESCRIPTION\|BUSINESS_NAME\|MARKETING_IMAGE\|SQUARE_MARKETING_IMAGE\|PORTRAIT_MARKETING_IMAGE\|TALL_PORTRAIT_MARKETING_IMAGE\|LOGO\|LANDSCAPE_LOGO\|YOUTUBE_VIDEO\|CALL_TO_ACTION_SELECTION` | |
| `--status` | `ENABLED\|PAUSED\|REMOVED` | Defaults to all non-removed links |

## google-ads asset-group-product-filters

### google-ads asset-group-product-filters get

Read and normalize Merchant Center product filters attached to one Performance Max asset group or every asset group in a campaign.

Beta: this command may still change.

```bash theme={null}
adside google-ads asset-group-product-filters get [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--campaign-id` | `<id>` | |
| `--asset-group-id` | `<id>` | |

## google-ads asset-groups

### google-ads asset-groups list

List asset groups for a Performance Max campaign with status and final URLs.

Beta: this command may still change.

```bash theme={null}
adside google-ads asset-groups list --campaign-id <id> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--campaign-id` (required) | `<id>` | |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--status` | `ENABLED\|PAUSED\|REMOVED` | |
| `--limit` | `<number>=100` | |

## google-ads assets

### google-ads assets list

List assets (text, image, video, callout, promotion) for a Google Ads account.

Beta: this command may still change.

```bash theme={null}
adside google-ads assets list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--type` | `TEXT\|IMAGE\|YOUTUBE_VIDEO\|CALLOUT\|PROMOTION` | |
| `--limit` | `<number>=100` | |

## google-ads audience-segments

### google-ads audience-segments list

List Google's ready-made audience segments (in-market, affinity, custom).

Beta: this command may still change.

```bash theme={null}
adside google-ads audience-segments list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--limit` | `<number>=100` | |

## google-ads campaign-ad-schedules

### google-ads campaign-ad-schedules get

Read the complete recurring weekly ad schedule for a Google Ads campaign.

Beta: this command may still change.

```bash theme={null}
adside google-ads campaign-ad-schedules get --campaign-id <id> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--campaign-id` (required) | `<id>` | |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |

## google-ads campaign-assets

### google-ads campaign-assets list

List callout and promotion assets linked at campaign level.

Beta: this command may still change.

```bash theme={null}
adside google-ads campaign-assets list --campaign-id <id> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--campaign-id` (required) | `<id>` | |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--field-type` | `CALLOUT\|PROMOTION` | |
| `--status` | `ENABLED\|PAUSED\|REMOVED` | |
| `--limit` | `<number>=100` | |

## google-ads campaign-budgets

### google-ads campaign-budgets list

List campaign budgets for a Google Ads account with usage information.

Beta: this command may still change.

```bash theme={null}
adside google-ads campaign-budgets list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--status` | `ENABLED\|REMOVED` | |
| `--limit` | `<number>=100` | |

## google-ads campaign-negative-keyword-lists

### google-ads campaign-negative-keyword-lists list

List the negative keyword lists attached to a campaign, with exact link resource names.

Beta: this command may still change.

```bash theme={null}
adside google-ads campaign-negative-keyword-lists list --campaign-id <id> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--campaign-id` (required) | `<id>` | |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |

## google-ads campaign-negative-keywords

### google-ads campaign-negative-keywords list

List direct negative keyword criteria for one campaign.

Beta: this command may still change.

```bash theme={null}
adside google-ads campaign-negative-keywords list --campaign-id <id> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--campaign-id` (required) | `<id>` | |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |

## google-ads campaign-performance

### google-ads campaign-performance get

Get campaign performance metrics (impressions, clicks, cost, conversions, CTR, CPC).

Beta: this command may still change.

```bash theme={null}
adside google-ads campaign-performance get [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--date-range` | `LAST_7_DAYS\|LAST_14_DAYS\|LAST_30_DAYS\|LAST_90_DAYS\|THIS_MONTH\|LAST_MONTH\|CUSTOM=LAST_30_DAYS` | |
| `--start-date` | `<start-date>` | YYYY-MM-DD, required when date\_range is CUSTOM |
| `--end-date` | `<end-date>` | YYYY-MM-DD, required when date\_range is CUSTOM |
| `--campaign-ids` | `'<json>'` | |
| `--metrics` | `'<json>'` | Metrics to retrieve, e.g. metrics.impressions, metrics.clicks, metrics.cost\_micros |
| `--segments` | `'<json>'` | Segment fields, e.g. segments.date, segments.device |
| `--order-by` | `<order-by>` | |
| `--limit` | `<1-10000>=100` | |

## google-ads campaigns

### google-ads campaigns list

List campaigns with optional filters for status and type.

Beta: this command may still change.

```bash theme={null}
adside google-ads campaigns list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--status` | `ENABLED\|PAUSED\|REMOVED` | |
| `--advertising-channel-type` | `SEARCH\|PERFORMANCE_MAX\|DISPLAY\|VIDEO\|SHOPPING\|DEMAND_GEN` | |
| `--limit` | `<number>=100` | |

## google-ads conversion-actions

### google-ads conversion-actions list

List conversion actions, including primary\_for\_goal, ownership, and value settings. include\_in\_conversions\_metric is deprecated; use primary\_for\_goal.

Beta: this command may still change.

```bash theme={null}
adside google-ads conversion-actions list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--status` | `ENABLED\|REMOVED\|HIDDEN` | |
| `--limit` | `<number>=100` | |

## google-ads customer-conversion-goals

### google-ads customer-conversion-goals list

List existing account-default conversion goals, their exact resource names, and biddability.

Beta: this command may still change.

```bash theme={null}
adside google-ads customer-conversion-goals list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |

## google-ads customers

### google-ads customers get

Get Google Ads account details including name, currency, timezone, and status.

Beta: this command may still change.

```bash theme={null}
adside google-ads customers get [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |

## google-ads geo-targets

### google-ads geo-targets get

Search geographic targets by name (countries, regions, cities).

Beta: this command may still change.

```bash theme={null}
adside google-ads geo-targets get --query <query> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--query` (required) | `<query>` | Location name to search, e.g. 'New York' or 'France' |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--country-code` | `<country-code>` | ISO country code to filter results, e.g. 'US' |
| `--limit` | `<number>=20` | |

## google-ads keyword-ad-groups

### google-ads keyword-ad-groups suggest

Ask Google to assign proposed keywords to the most relevant existing ad groups.

Beta: this command may still change.

```bash theme={null}
adside google-ads keyword-ad-groups suggest --keywords '<json>' --ad-group-ids '<json>' [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--keywords` (required) | `'<json>'` | |
| `--ad-group-ids` (required) | `'<json>'` | Existing ad group IDs from `adside google-ads ad-groups list`. Google only suggests among these groups. |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |

## google-ads keyword-ideas

### google-ads keyword-ideas generate

Generate new Google Search keyword ideas from up to 20 seed terms, a public page, both, or a whole site.

Beta: this command may still change.

```bash theme={null}
adside google-ads keyword-ideas generate --seed '<json>' [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--seed` (required) | `'<json>'` | Exactly one seed mode: keywords, one page, both, or a whole site. |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--geo-target-ids` | `'<json>'` | Geo target IDs from `adside google-ads geo-targets get`. Strongly recommended; omitting them requests worldwide ideas. |
| `--language-id` | `<id>=1000` | Language ID from `adside google-ads languages get`. Defaults to English (1000). |
| `--network` | `GOOGLE_SEARCH\|GOOGLE_SEARCH_AND_PARTNERS=GOOGLE_SEARCH` | |
| `--include-adult-keywords` | `true\|false=false` | |
| `--include-average-cpc` | `true\|false=true` | |
| `--include-monthly-volumes` | `true\|false=false` | Show the monthly volume series returned for every idea. |
| `--page-size` | `<1-1000>=100` | Ideas to return in this call. Deliberately capped below Google's 10,000-result limit to protect agent context. |
| `--page-token` | `<next>` | Exact next-page token from a previous call. All other request fields must remain identical. |

## google-ads keyword-performance

### google-ads keyword-performance get

Get keyword-level performance metrics with quality score breakdown (expected CTR, ad relevance, landing page experience).

Beta: this command may still change.

```bash theme={null}
adside google-ads keyword-performance get [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--ad-group-id` | `<id>` | |
| `--campaign-id` | `<id>` | |
| `--date-range` | `LAST_7_DAYS\|LAST_14_DAYS\|LAST_30_DAYS\|LAST_90_DAYS\|THIS_MONTH\|LAST_MONTH\|CUSTOM=LAST_30_DAYS` | |
| `--start-date` | `<start-date>` | |
| `--end-date` | `<end-date>` | |
| `--limit` | `<number>=100` | |

## google-ads keyword-plan

### google-ads keyword-plan forecast

Forecast cost plus clicks or conversions for a hypothetical Search keyword plan.

Beta: this command may still change.

```bash theme={null}
adside google-ads keyword-plan forecast --ad-groups '<json>' --bidding-strategy '<json>' [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-groups` (required) | `'<json>'` | The hypothetical ad-group structure. This does not create anything in Google Ads. |
| `--bidding-strategy` (required) | `'<json>'` | |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--geo-target-ids` | `'<json>'` | Geo target IDs from `adside google-ads geo-targets get`. |
| `--language-ids` | `'<json>'` | |
| `--currency-code` | `<currency-code>` | Omit to use the connected account's currency. |
| `--start-date` | `<start-date>` | Forecast start in the account time zone. Must be in the future. |
| `--end-date` | `<end-date>` | Forecast end in the account time zone, no more than one year ahead. |

## google-ads keyword-plan-metrics

### google-ads keyword-plan-metrics get

Google Keyword Planner data for keywords that are NOT yet in the account: average monthly searches, top-of-page bid range, competition and average CPC, for pre-launch keyword research.

Beta: this command may still change.

```bash theme={null}
adside google-ads keyword-plan-metrics get --keywords '<json>' [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--keywords` (required) | `'<json>'` | The exact terms to measure. Send them all in one call — Google allows only 1 request/second per account, so splitting is slower, not safer. |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--geo-target-ids` | `'<json>'` | Geo target constant IDs (from `adside google-ads geo-targets get`), e.g. '21137' for California. STRONGLY recommended: omitting this returns worldwide volumes, which can be an order of magnitude higher and is almost never what was asked. |
| `--language-id` | `<id>` | Language constant ID (from `adside google-ads languages get`). Defaults to '1000' (English). |
| `--network` | `GOOGLE_SEARCH\|GOOGLE_SEARCH_AND_PARTNERS=GOOGLE_SEARCH` | GOOGLE\_SEARCH matches what Keyword Planner shows by default. |
| `--include-average-cpc` | `true\|false=true` | Include the historical average CPC alongside the bid range. |
| `--include-monthly-volumes` | `true\|false=false` | Include the 12-month volume series per keyword. Off by default: it multiplies the response size by \~12 and is only useful for seasonality. |

## google-ads keywords

### google-ads keywords list

List keywords for an ad group with match type, quality score, and performance data.

Beta: this command may still change.

```bash theme={null}
adside google-ads keywords list --ad-group-id <id> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-group-id` (required) | `<id>` | |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--status` | `ENABLED\|PAUSED\|REMOVED` | |
| `--limit` | `<number>=100` | |

## google-ads languages

### google-ads languages get

Search Google Ads language constants by name or ISO code.

Beta: this command may still change.

```bash theme={null}
adside google-ads languages get [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--query` | `<query>` | Filter by language name or ISO code, e.g. 'Spanish' or 'es'. |
| `--limit` | `<number>=200` | |

## google-ads negative-keyword-lists

### google-ads negative-keyword-lists list

List active reusable campaign negative keyword lists with member and campaign counts.

Beta: this command may still change.

```bash theme={null}
adside google-ads negative-keyword-lists list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |

## google-ads product-filter-values

### google-ads product-filter-values list

List values currently present in a Performance Max campaign's Merchant Center inventory for a supported product filter attribute.

Beta: this command may still change.

```bash theme={null}
adside google-ads product-filter-values list --campaign-id <id> --attribute product_type_l1|product_type_l2|product_type_l3|product_type_l4|product_type_l5|brand|custom_label_0|custom_label_1|custom_label_2|custom_label_3|custom_label_4 [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--campaign-id` (required) | `<id>` | |
| `--attribute` (required) | `product_type_l1\|product_type_l2\|product_type_l3\|product_type_l4\|product_type_l5\|brand\|custom_label_0\|custom_label_1\|custom_label_2\|custom_label_3\|custom_label_4` | |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--statuses` | `'<json>'` | |
| `--search` | `<search>` | |
| `--limit` | `<1-500>=100` | |

## google-ads search-terms-report

### google-ads search-terms-report get

Get actual search queries that triggered your ads (vs keywords you're targeting).

Beta: this command may still change.

```bash theme={null}
adside google-ads search-terms-report get [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--campaign-id` | `<id>` | |
| `--ad-group-id` | `<id>` | |
| `--date-range` | `LAST_7_DAYS\|LAST_14_DAYS\|LAST_30_DAYS\|LAST_90_DAYS\|THIS_MONTH\|LAST_MONTH\|CUSTOM=LAST_30_DAYS` | |
| `--start-date` | `<start-date>` | |
| `--end-date` | `<end-date>` | |
| `--limit` | `<number>=100` | |

## google-ads shared-negative-keywords

### google-ads shared-negative-keywords list

List all keyword members of one active shared negative keyword list, including exact resource names for removal.

Beta: this command may still change.

```bash theme={null}
adside google-ads shared-negative-keywords list --shared-set-id <id> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--shared-set-id` (required) | `<id>` | |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |

## google-ads user-lists

### google-ads user-lists list

List the account's remarketing lists — the people who visited your own site, as opposed to the ready-made segments Google publishes (those are `adside google-ads audience-segments list`).

Beta: this command may still change.

```bash theme={null}
adside google-ads user-lists list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--customer-id` | `<id>` | Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--limit` | `<number>=100` | |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.