pp-google-ads

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/marketing/google-ads/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# Google Ads — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `google-ads-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install google-ads --cli-only
   ```
2. Verify: `google-ads-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/marketing/google-ads/cmd/google-ads-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## Command Reference

**audience_insights** — Google Ads audience insights operations

- `google-ads-pp-cli audience_insights` — Lists date ranges for which audience insights data can be requested.

**customers** — Google Ads customers operations

- `google-ads-pp-cli customers create_customer_client` — Creates a new client under manager. The new client customer is returned.
- `google-ads-pp-cli customers generate_ad_group_themes` — Returns a list of suggested AdGroups and suggested modifications (text, match type) for the given keywords.
- `google-ads-pp-cli customers generate_audience_composition_insights` — Returns a collection of attributes that are represented in an audience of interest, with metrics that compare each...
- `google-ads-pp-cli customers generate_audience_overlap_insights` — Returns a collection of audience attributes along with estimates of the overlap between their potential YouTube...
- `google-ads-pp-cli customers generate_creator_insights` — Returns insights for a collection of YouTube Creators and Channels.
- `google-ads-pp-cli customers generate_insights_finder_report` — Creates a saved report that can be viewed in the Insights Finder tool.
- `google-ads-pp-cli customers generate_keyword_forecast_metrics` — Returns metrics (such as impressions, clicks, total cost) of a keyword forecast for the given campaign.
- `google-ads-pp-cli customers generate_keyword_historical_metrics` — Returns a list of keyword historical metrics.
- `google-ads-pp-cli customers generate_keyword_ideas` — Returns a list of keyword ideas.
- `google-ads-pp-cli customers generate_reach_forecast` — Generates a reach forecast for a given targeting / product mix.
- `google-ads-pp-cli customers generate_shareable_previews` — Returns the requested Shareable Preview.
- `google-ads-pp-cli customers generate_suggested_targeting_insights` — Returns a collection of targeting insights (e.g. targetable audiences) that are relevant to the requested audience.
- `google-ads-pp-cli customers generate_targeting_suggestion_metrics` — Returns potential reach metrics for targetable audiences. This method helps answer questions like 'How many Men aged...
- `google-ads-pp-cli customers generate_trending_insights` — Returns insights for trending content on YouTube.
- `google-ads-pp-cli customers get_identity_verification` — Returns Identity Verification information.
- `google-ads-pp-cli customers list_accessible_customers` — Returns resource names of customers directly accessible by the user authenticating the call.
- `google-ads-pp-cli customers mutate` — Updates a customer. Operation statuses are returned.
- `google-ads-pp-cli customers remove_campaign_automatically_created_asset` — Removes automatically created assets from a campaign.
- `google-ads-pp-cli customers search_audience_insights_attributes` — Searches for audience attributes that can be used to generate insights.
- `google-ads-pp-cli customers start_identity_verification` — Starts Identity Verification for a given verification program type. Statuses are returned.
- `google-ads-pp-cli customers suggest_brands` — Rpc to return a list of matching brands based on a prefix for this customer.
- `google-ads-pp-cli customers suggest_keyword_themes` — Suggests keyword themes to advertise on.
- `google-ads-pp-cli customers suggest_smart_campaign_ad` — Suggests a Smart campaign ad compatible with the Ad family of resources, based on data points such as targeting and...
- `google-ads-pp-cli customers suggest_smart_campaign_budget_options` — Returns BudgetOption suggestions.
- `google-ads-pp-cli customers suggest_travel_assets` — Returns Travel Asset suggestions. Asset suggestions are returned on a best-effort basis. There are no guarantees...
- `google-ads-pp-cli customers upload_call_conversions` — Processes the given call conversions.
- `google-ads-pp-cli customers upload_click_conversions` — Processes the given click conversions.
- `google-ads-pp-cli customers upload_conversion_adjustments` — Processes the given conversion adjustments.
- `google-ads-pp-cli customers upload_user_data` — Uploads the given user data.

**customers_account_budget_proposals** — Google Ads customers account budget proposals operations

- `google-ads-pp-cli customers_account_budget_proposals <customerId>` — Creates, updates, or removes account budget proposals. Operation statuses are returned.

**customers_account_links** — Google Ads customers account links operations

- `google-ads-pp-cli customers_account_links create` — Creates an account link.
- `google-ads-pp-cli customers_account_links mutate` — Creates or removes an account link. From V5, create is not supported through AccountLinkService.MutateAccountLink....

**customers_ad_group_ad_labels** — Google Ads customers ad group ad labels operations

- `google-ads-pp-cli customers_ad_group_ad_labels <customerId>` — Creates and removes ad group ad labels. Operation statuses are returned.

**customers_ad_group_ads** — Google Ads customers ad group ads operations

- `google-ads-pp-cli customers_ad_group_ads mutate` — Creates, updates, or removes ads. Operation statuses are returned.
- `google-ads-pp-cli customers_ad_group_ads remove_automatically_created_assets` — Remove automatically created assets from an ad.

**customers_ad_group_asset_sets** — Google Ads customers ad group asset sets operations

- `google-ads-pp-cli customers_ad_group_asset_sets <customerId>` — Creates, or removes ad group asset sets. Operation statuses are returned.

**customers_ad_group_assets** — Google Ads customers ad group assets operations

- `google-ads-pp-cli customers_ad_group_assets <customerId>` — Creates, updates, or removes ad group assets. Operation statuses are returned.

**customers_ad_group_bid_modifiers** — Google Ads customers ad group bid modifiers operations

- `google-ads-pp-cli customers_ad_group_bid_modifiers <customerId>` — Creates, updates, or removes ad group bid modifiers. Operation statuses are returned.

**customers_ad_group_criteria** — Google Ads customers ad group criteria operations

- `google-ads-pp-cli customers_ad_group_criteria <customerId>` — Creates, updates, or removes criteria. Operation statuses are returned.

**customers_ad_group_criterion_customizers** — Google Ads customers ad group criterion customizers operations

- `google-ads-pp-cli customers_ad_group_criterion_customizers <customerId>` — Creates, updates or removes ad group criterion customizers. Operation statuses are returned.

**customers_ad_group_criterion_labels** — Google Ads customers ad group criterion labe