--- name: pp-google-ads description: "Google Ads API for account discovery, GAQL reporting, campaigns, budgets, assets, conversions, audiences, planning, and billing operations. Trigger phrases: `pull a Google Ads report`, `GAQL query`, `check campaign performance`, `use google-ads`." license: "Apache-2.0" argument-hint: " [args] | install cli|mcp" allowed-tools: "Read Bash" metadata: openclaw: requires: bins: - google-ads-pp-cli install: - kind: go bins: [google-ads-pp-cli] module: github.com/mvanhorn/printing-press-library/library/marketing/google-ads/cmd/google-ads-pp-cli --- # 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.6 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 ` — 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 ` — 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 ` — 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 ` — 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 ` — 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 ` — 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 ` — Creates, updates or removes ad group criterion customizers. Operation statuses are returned. **customers_ad_group_criterion_labels** — Google Ads customers ad group criterion labels operations - `google-ads-pp-cli customers-ad-group-criterion-labels ` — Creates and removes ad group criterion labels. Operation statuses are returned. **customers_ad_group_customizers** — Google Ads customers ad group customizers operations - `google-ads-pp-cli customers-ad-group-customizers ` — Creates, updates or removes ad group customizers. Operation statuses are returned. **customers_ad_group_labels** — Google Ads customers ad group labels operations - `google-ads-pp-cli customers-ad-group-labels ` — Creates and removes ad group labels. Operation statuses are returned. **customers_ad_groups** — Google Ads customers ad groups operations - `google-ads-pp-cli customers-ad-groups ` — Creates, updates, or removes ad groups. Operation statuses are returned. **customers_ad_parameters** — Google Ads customers ad parameters operations - `google-ads-pp-cli customers-ad-parameters ` — Creates, updates, or removes ad parameters. Operation statuses are returned. **customers_ads** — Google Ads customers ads operations - `google-ads-pp-cli customers-ads ` — Updates ads. Operation statuses are returned. Updating ads is not supported for TextAd, ExpandedDynamicSearchAd,... **customers_asset_generations** — Google Ads customers asset generations operations - `google-ads-pp-cli customers-asset-generations generate-images` — Uses generative AI to generate images that can be used as assets in a campaign. - `google-ads-pp-cli customers-asset-generations generate-text` — Uses generative AI to generate text that can be used as assets in a campaign. **customers_asset_group_assets** — Google Ads customers asset group assets operations - `google-ads-pp-cli customers-asset-group-assets ` — Creates, updates or removes asset group assets. Operation statuses are returned. **customers_asset_group_listing_group_filters** — Google Ads customers asset group listing group filters operations - `google-ads-pp-cli customers-asset-group-listing-group-filters ` — Creates, updates or removes asset group listing group filters. Operation statuses are returned. **customers_asset_group_signals** — Google Ads customers asset group signals operations - `google-ads-pp-cli customers-asset-group-signals ` — Creates or removes asset group signals. Operation statuses are returned. **customers_asset_groups** — Google Ads customers asset groups operations - `google-ads-pp-cli customers-asset-groups ` — Creates, updates or removes asset groups. Operation statuses are returned. **customers_asset_set_assets** — Google Ads customers asset set assets operations - `google-ads-pp-cli customers-asset-set-assets ` — Creates, updates or removes asset set assets. Operation statuses are returned. **customers_asset_sets** — Google Ads customers asset sets operations - `google-ads-pp-cli customers-asset-sets ` — Creates, updates or removes asset sets. Operation statuses are returned. **customers_assets** — Google Ads customers assets operations - `google-ads-pp-cli customers-assets ` — Creates assets. Operation statuses are returned. **customers_audiences** — Google Ads customers audiences operations - `google-ads-pp-cli customers-audiences ` — Creates audiences. Operation statuses are returned. **customers_batch_jobs** — Google Ads customers batch jobs operations - `google-ads-pp-cli customers-batch-jobs add-operations` — Add operations to the batch job. - `google-ads-pp-cli customers-batch-jobs list-results` — Returns the results of the batch job. The job must be done. Supports standard list paging. - `google-ads-pp-cli customers-batch-jobs mutate` — Mutates a batch job. - `google-ads-pp-cli customers-batch-jobs run` — Runs the batch job. The Operation.metadata field type is BatchJobMetadata. When finished, the long running operation... **customers_bidding_data_exclusions** — Google Ads customers bidding data exclusions operations - `google-ads-pp-cli customers-bidding-data-exclusions ` — Creates, updates, or removes data exclusions. Operation statuses are returned. **customers_bidding_seasonality_adjustments** — Google Ads customers bidding seasonality adjustments operations - `google-ads-pp-cli customers-bidding-seasonality-adjustments ` — Creates, updates, or removes seasonality adjustments. Operation statuses are returned. **customers_bidding_strategies** — Google Ads customers bidding strategies operations - `google-ads-pp-cli customers-bidding-strategies ` — Creates, updates, or removes bidding strategies. Operation statuses are returned. **customers_billing_setups** — Google Ads customers billing setups operations - `google-ads-pp-cli customers-billing-setups ` — Creates a billing setup, or cancels an existing billing setup. **customers_campaign_asset_sets** — Google Ads customers campaign asset sets operations - `google-ads-pp-cli customers-campaign-asset-sets ` — Creates, updates or removes campaign asset sets. Operation statuses are returned. **customers_campaign_assets** — Google Ads customers campaign assets operations - `google-ads-pp-cli customers-campaign-assets ` — Creates, updates, or removes campaign assets. Operation statuses are returned. **customers_campaign_bid_modifiers** — Google Ads customers campaign bid modifiers operations - `google-ads-pp-cli customers-campaign-bid-modifiers ` — Creates, updates, or removes campaign bid modifiers. Operation statuses are returned. **customers_campaign_budgets** — Google Ads customers campaign budgets operations - `google-ads-pp-cli customers-campaign-budgets ` — Creates, updates, or removes campaign budgets. Operation statuses are returned. **customers_campaign_conversion_goals** — Google Ads customers campaign conversion goals operations - `google-ads-pp-cli customers-campaign-conversion-goals ` — Creates, updates or removes campaign conversion goals. Operation statuses are returned. **customers_campaign_criteria** — Google Ads customers campaign criteria operations - `google-ads-pp-cli customers-campaign-criteria ` — Creates, updates, or removes criteria. Operation statuses are returned. **customers_campaign_customizers** — Google Ads customers campaign customizers operations - `google-ads-pp-cli customers-campaign-customizers ` — Creates, updates or removes campaign customizers. Operation statuses are returned. **customers_campaign_drafts** — Google Ads customers campaign drafts operations - `google-ads-pp-cli customers-campaign-drafts list-async-errors` — Returns all errors that occurred during CampaignDraft promote. Throws an error if called before campaign draft is... - `google-ads-pp-cli customers-campaign-drafts mutate` — Creates, updates, or removes campaign drafts. Operation statuses are returned. - `google-ads-pp-cli customers-campaign-drafts promote` — Promotes the changes in a draft back to the base campaign. This method returns a Long Running Operation (LRO)... **customers_campaign_goal_configs** — Google Ads customers campaign goal configs operations - `google-ads-pp-cli customers-campaign-goal-configs ` — Create or update campaign goal configs. **customers_campaign_groups** — Google Ads customers campaign groups operations - `google-ads-pp-cli customers-campaign-groups ` — Creates, updates, or removes campaign groups. Operation statuses are returned. **customers_campaign_labels** — Google Ads customers campaign labels operations - `google-ads-pp-cli customers-campaign-labels ` — Creates and removes campaign-label relationships. Operation statuses are returned. **customers_campaign_lifecycle_goal** — Google Ads customers campaign lifecycle goal operations - `google-ads-pp-cli customers-campaign-lifecycle-goal ` — Process the given campaign lifecycle configurations. **customers_campaign_shared_sets** — Google Ads customers campaign shared sets operations - `google-ads-pp-cli customers-campaign-shared-sets ` — Creates or removes campaign shared sets. Operation statuses are returned. **customers_campaigns** — Google Ads customers campaigns operations - `google-ads-pp-cli customers-campaigns enable-pmax-brand-guidelines` — Enables Brand Guidelines for Performance Max campaigns. - `google-ads-pp-cli customers-campaigns mutate` — Creates, updates, or removes campaigns. Operation statuses are returned. **customers_conversion_actions** — Google Ads customers conversion actions operations - `google-ads-pp-cli customers-conversion-actions ` — Creates, updates or removes conversion actions. Operation statuses are returned. **customers_conversion_custom_variables** — Google Ads customers conversion custom variables operations - `google-ads-pp-cli customers-conversion-custom-variables ` — Creates or updates conversion custom variables. Operation statuses are returned. **customers_conversion_goal_campaign_configs** — Google Ads customers conversion goal campaign configs operations - `google-ads-pp-cli customers-conversion-goal-campaign-configs ` — Creates, updates or removes conversion goal campaign config. Operation statuses are returned. **customers_conversion_value_rule_sets** — Google Ads customers conversion value rule sets operations - `google-ads-pp-cli customers-conversion-value-rule-sets ` — Creates, updates or removes conversion value rule sets. Operation statuses are returned. **customers_conversion_value_rules** — Google Ads customers conversion value rules operations - `google-ads-pp-cli customers-conversion-value-rules ` — Creates, updates, or removes conversion value rules. Operation statuses are returned. **customers_custom_audiences** — Google Ads customers custom audiences operations - `google-ads-pp-cli customers-custom-audiences ` — Creates or updates custom audiences. Operation statuses are returned. **customers_custom_conversion_goals** — Google Ads customers custom conversion goals operations - `google-ads-pp-cli customers-custom-conversion-goals ` — Creates, updates or removes custom conversion goals. Operation statuses are returned. **customers_custom_interests** — Google Ads customers custom interests operations - `google-ads-pp-cli customers-custom-interests ` — Creates or updates custom interests. Operation statuses are returned. **customers_customer_asset_sets** — Google Ads customers customer asset sets operations - `google-ads-pp-cli customers-customer-asset-sets ` — Creates, or removes customer asset sets. Operation statuses are returned. **customers_customer_assets** — Google Ads customers customer assets operations - `google-ads-pp-cli customers-customer-assets ` — Creates, updates, or removes customer assets. Operation statuses are returned. **customers_customer_client_links** — Google Ads customers customer client links operations - `google-ads-pp-cli customers-customer-client-links ` — Creates or updates a customer client link. Operation statuses are returned. **customers_customer_conversion_goals** — Google Ads customers customer conversion goals operations - `google-ads-pp-cli customers-customer-conversion-goals ` — Creates, updates or removes customer conversion goals. Operation statuses are returned. **customers_customer_customizers** — Google Ads customers customer customizers operations - `google-ads-pp-cli customers-customer-customizers ` — Creates, update