Google Ads - Adside

See Using commands 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.

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.

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.

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.

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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`

​google-ads accessible-customers

​google-ads accessible-customers list

​google-ads ad-groups

​google-ads ad-groups list

​google-ads ads

​google-ads ads list

​google-ads asset-group-assets

​google-ads asset-group-assets list

​google-ads asset-group-product-filters

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

​google-ads asset-groups

​google-ads asset-groups list

​google-ads assets

​google-ads assets list

​google-ads audience-segments

​google-ads audience-segments list

​google-ads campaign-ad-schedules

​google-ads campaign-ad-schedules get

​google-ads campaign-assets

​google-ads campaign-assets list

​google-ads campaign-budgets

​google-ads campaign-budgets list

​google-ads campaign-negative-keyword-lists

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

​google-ads campaign-negative-keywords

​google-ads campaign-negative-keywords list

​google-ads campaign-performance

​google-ads campaign-performance get

​google-ads campaigns

​google-ads campaigns list

​google-ads conversion-actions

​google-ads conversion-actions list

​google-ads customer-conversion-goals

​google-ads customer-conversion-goals list

​google-ads customers

​google-ads customers get

​google-ads geo-targets

​google-ads geo-targets get

​google-ads keyword-ad-groups

​google-ads keyword-ad-groups suggest

​google-ads keyword-ideas

​google-ads keyword-ideas generate

​google-ads keyword-performance

​google-ads keyword-performance get

​google-ads keyword-plan

​google-ads keyword-plan forecast

​google-ads keyword-plan-metrics

​google-ads keyword-plan-metrics get

​google-ads keywords

​google-ads keywords list

​google-ads languages

​google-ads languages get

​google-ads negative-keyword-lists

​google-ads negative-keyword-lists list

​google-ads product-filter-values

​google-ads product-filter-values list

​google-ads search-terms-report

​google-ads search-terms-report get

​google-ads shared-negative-keywords

​google-ads shared-negative-keywords list

​google-ads user-lists

​google-ads user-lists list