mvanhorn 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:
- Install via the Printing Press installer. It defaults binaries to
$HOME/.local/binon macOS/Linux and%LOCALAPPDATA%\Programs\PrintingPress\binon Windows:npx -y @mvanhorn/printing-press-library install google-ads --cli-only - Verify:
google-ads-pp-cli --version - Ensure the reported install directory is on
$PATHfor 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):
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 labels operations
google-ads-pp-cli customers-ad-group-criterion-labels <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— Creates, updates, or removes ad parameters. Operation statuses are returned.
customers_ads — Google Ads customers ads operations
google-ads-pp-cli customers-ads <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— Creates, updates or removes asset sets. Operation statuses are returned.
customers_assets — Google Ads customers assets operations
google-ads-pp-cli customers-assets <customerId>— Creates assets. Operation statuses are returned.
customers_audiences — Google Ads customers audiences operations
google-ads-pp-cli customers-audiences <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— Create or update campaign goal configs.
customers_campaign_groups — Google Ads customers campaign groups operations
google-ads-pp-cli customers-campaign-groups <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— 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 <customerId>— Creates, updates or removes customer customizers. Operation statuses are returned.
customers_customer_labels — Google Ads customers customer labels operations
google-ads-pp-cli customers-customer-labels <customerId>— Creates and removes customer-label relationships. Operation statuses are returned.
customers_customer_lifecycle_goal — Google Ads customers customer lifecycle goal operations
google-ads-pp-cli customers-customer-lifecycle-goal <customerId>— Process the given customer lifecycle configurations.
customers_customer_manager_links — Google Ads customers customer manager links operations
google-ads-pp-cli customers-customer-manager-links move-manager-link— Moves a client customer to a new manager customer. This simplifies the complex request that requires two operations...google-ads-pp-cli customers-customer-manager-links mutate— Updates customer manager links. Operation statuses are returned.
customers_customer_negative_criteria — Google Ads customers customer negative criteria operations
google-ads-pp-cli customers-customer-negative-criteria <customerId>— Creates or removes criteria. Operation statuses are returned.
customers_customer_sk_ad_network_conversion_value_schemas — Google Ads customers customer sk ad network conversion value schemas operations
google-ads-pp-cli customers-customer-sk-ad-network-conversion-value-schemas <customerId>— Creates or updates the CustomerSkAdNetworkConversionValueSchema.
customers_customer_user_access_invitations — Google Ads customers customer user access invitations operations
google-ads-pp-cli customers-customer-user-access-invitations <customerId>— Creates or removes an access invitation.
customers_customer_user_accesses — Google Ads customers customer user accesses operations
google-ads-pp-cli customers-customer-user-accesses <customerId>— Updates, removes permission of a user on a given customer. Operation statuses are returned.
customers_customizer_attributes — Google Ads customers customizer attributes operations
google-ads-pp-cli customers-customizer-attributes <customerId>— Creates, updates or removes customizer attributes. Operation statuses are returned.
customers_data_links — Google Ads customers data links operations
google-ads-pp-cli customers-data-links create— Creates a data link. The requesting Google Ads account name and account ID will be shared with the third party (such...google-ads-pp-cli customers-data-links remove— Remove a data link.google-ads-pp-cli customers-data-links update— Update a data link.
customers_experiment_arms — Google Ads customers experiment arms operations
google-ads-pp-cli customers-experiment-arms <customerId>— Creates, updates, or removes experiment arms. Operation statuses are returned.
customers_experiments — Google Ads customers experiments operations
google-ads-pp-cli customers-experiments end-experiment— Immediately ends an experiment, changing the experiment's scheduled end date and without waiting for end of day. End...google-ads-pp-cli customers-experiments graduate-experiment— Graduates an experiment to a full campaign.google-ads-pp-cli customers-experiments list-experiment-async-errors— Returns all errors that occurred during the last Experiment update (either scheduling or promotion). Supports...google-ads-pp-cli customers-experiments mutate— Creates, updates, or removes experiments. Operation statuses are returned.google-ads-pp-cli customers-experiments promote-experiment— Promotes the trial campaign thus applying changes in the trial campaign to the base campaign. This method returns a...google-ads-pp-cli customers-experiments schedule-experiment— Schedule an experiment. The in design campaign will be converted into a real campaign (called the experiment...
customers_goals — Google Ads customers goals operations
google-ads-pp-cli customers-goals <customerId>— Create or update goals.
customers-google-ads — Google Ads customers google ads operations
google-ads-pp-cli customers-google-ads mutate— Creates, updates, or removes resources. This method supports atomic transactions with multiple types of resources....google-ads-pp-cli customers-google-ads search— Returns all rows that match the search query.google-ads-pp-cli customers-google-ads search-stream— Returns all rows that match the search stream query.
customers_invoices — Google Ads customers invoices operations
google-ads-pp-cli customers-invoices <customerId>— Returns all invoices associated with a billing setup, for a given month.
customers_keyword_plan_ad_group_keywords — Google Ads customers keyword plan ad group keywords operations
google-ads-pp-cli customers-keyword-plan-ad-group-keywords <customerId>— Creates, updates, or removes Keyword Plan ad group keywords. Operation statuses are returned.
customers_keyword_plan_ad_groups — Google Ads customers keyword plan ad groups operations
google-ads-pp-cli customers-keyword-plan-ad-groups <customerId>— Creates, updates, or removes Keyword Plan ad groups. Operation statuses are returned.
customers_keyword_plan_campaign_keywords — Google Ads customers keyword plan campaign keywords operations
google-ads-pp-cli customers-keyword-plan-campaign-keywords <customerId>— Creates, updates, or removes Keyword Plan campaign keywords. Operation statuses are returned.
customers_keyword_plan_campaigns — Google Ads customers keyword plan campaigns operations
google-ads-pp-cli customers-keyword-plan-campaigns <customerId>— Creates, updates, or removes Keyword Plan campaigns. Operation statuses are returned.
customers_keyword_plans — Google Ads customers keyword plans operations
google-ads-pp-cli customers-keyword-plans <customerId>— Creates, updates, or removes keyword plans. Operation statuses are returned.
customers_labels — Google Ads customers labels operations
google-ads-pp-cli customers-labels <customerId>— Creates, updates, or removes labels. Operation statuses are returned.
customers_local_services — Google Ads customers local services operations
google-ads-pp-cli customers-local-services <customerId>— RPC to append Local Services Lead Conversation resources to Local Services Lead resources.
customers_local_services_leads — Google Ads customers local services leads operations
google-ads-pp-cli customers-local-services-leads <resourceName>— RPC to provide feedback on Local Services Lead resources.
customers_offline_user_data_jobs — Google Ads customers offline user data jobs operations
google-ads-pp-cli customers-offline-user-data-jobs add-operations— Adds operations to the offline user data job.google-ads-pp-cli customers-offline-user-data-jobs create— Creates an offline user data job.google-ads-pp-cli customers-offline-user-data-jobs run— Runs the offline user data job. When finished, the long running operation will contain the processing result or...
customers_operations — Google Ads customers operations operations
google-ads-pp-cli customers-operations cancel— Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the...google-ads-pp-cli customers-operations delete— Deletes a long-running operation. This method indicates that the client is no longer interested in the operation...google-ads-pp-cli customers-operations get— Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at...google-ads-pp-cli customers-operations list— Lists operations that match the specified filter in the request. If the server doesn't support this method, it...google-ads-pp-cli customers-operations wait— Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the...
customers_payments_accounts — Google Ads customers payments accounts operations
google-ads-pp-cli customers-payments-accounts <customerId>— Returns all payments accounts associated with all managers between the login customer ID and specified serving...
customers_product_link_invitations — Google Ads customers product link invitations operations
google-ads-pp-cli customers-product-link-invitations create— Creates a product link invitation.google-ads-pp-cli customers-product-link-invitations remove— Remove a product link invitation.google-ads-pp-cli customers-product-link-invitations update— Update a product link invitation.
customers_product_links — Google Ads customers product links operations
google-ads-pp-cli customers-product-links create— Creates a product link.google-ads-pp-cli customers-product-links remove— Removes a product link.
customers_recommendation_subscriptions — Google Ads customers recommendation subscriptions operations
google-ads-pp-cli customers-recommendation-subscriptions <customerId>— Mutates given subscription with corresponding apply parameters.
customers_recommendations — Google Ads customers recommendations operations
google-ads-pp-cli customers-recommendations apply— Applies given recommendations with corresponding apply parameters.google-ads-pp-cli customers-recommendations dismiss— Dismisses given recommendations.google-ads-pp-cli customers-recommendations generate— Generates Recommendations based off the requested recommendation_types.
customers_remarketing_actions — Google Ads customers remarketing actions operations
google-ads-pp-cli customers-remarketing-actions <customerId>— Creates or updates remarketing actions. Operation statuses are returned.
customers_shared_criteria — Google Ads customers shared criteria operations
google-ads-pp-cli customers-shared-criteria <customerId>— Creates or removes shared criteria. Operation statuses are returned.
customers_shared_sets — Google Ads customers shared sets operations
google-ads-pp-cli customers-shared-sets <customerId>— Creates, updates, or removes shared sets. Operation statuses are returned.
customers_smart_campaign_settings — Google Ads customers smart campaign settings operations
google-ads-pp-cli customers-smart-campaign-settings get-smart-campaign-status— Returns the status of the requested Smart campaign.google-ads-pp-cli customers-smart-campaign-settings mutate— Updates Smart campaign settings for campaigns.
customers_third_party_app_analytics_links — Google Ads customers third party app analytics links operations
google-ads-pp-cli customers-third-party-app-analytics-links <resourceName>— Regenerate ThirdPartyAppAnalyticsLink.shareable_link_id that should be provided to the third party when setting up...
customers_user_list_customer_types — Google Ads customers user list customer types operations
google-ads-pp-cli customers-user-list-customer-types <customerId>— Attach or remove user list customer types. Operation statuses are returned.
customers_user_lists — Google Ads customers user lists operations
google-ads-pp-cli customers-user-lists <customerId>— Creates or updates user lists. Operation statuses are returned.
geo_target_constants — Google Ads geo target constants operations
google-ads-pp-cli geo-target-constants— Returns GeoTargetConstant suggestions by location name or by resource name.
google_ads — Google Ads google ads operations
google-ads-pp-cli google-ads generate-conversion-rates— Returns a collection of conversion rate suggestions for supported plannable products.google-ads-pp-cli google-ads list-plannable-locations— Returns the list of plannable locations (for example, countries).google-ads-pp-cli google-ads list-plannable-products— Returns the list of per-location plannable YouTube ad formats with allowed targeting.google-ads-pp-cli google-ads list-plannable-user-interests— Returns the list of plannable user interests. A plannable user interest is one that can be targeted in a reach...google-ads-pp-cli google-ads list-plannable-user-lists— Returns the list of plannable user lists with their plannable status. User lists may not be plannable for a number...
google_ads_fields — Google Ads google ads fields operations
google-ads-pp-cli google-ads-fields get— Returns just the requested field.google-ads-pp-cli google-ads-fields search— Returns all fields that match the search query.
keyword_theme_constants — Google Ads keyword theme constants operations
google-ads-pp-cli keyword-theme-constants— Returns KeywordThemeConstant suggestions by keyword themes.
Finding the right command
When you know what you want to do but not which command does it, ask the CLI directly:
google-ads-pp-cli which "<capability in your own words>"
which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.
Auth Setup
Authenticate via the OAuth2 flow. auth login opens a browser, runs the consent flow, and stores a refresh token so access tokens are minted automatically:
google-ads-pp-cli auth login --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET
--client-id / --client-secret default to $GOOGLE_ADS_CLIENT_ID / $GOOGLE_ADS_CLIENT_SECRET when set. Check or clear the stored grant with google-ads-pp-cli auth status and google-ads-pp-cli auth logout.
Also set GOOGLE_ADS_DEVELOPER_TOKEN; set GOOGLE_ADS_LOGIN_CUSTOMER_ID when calling through a manager account.
Run google-ads-pp-cli doctor to verify setup.
Agent Mode
Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.
Pipeable — JSON on stdout, errors on stderr
Filterable —
--selectkeeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:google-ads-pp-cli customers-google-ads search mock-value --agent --select id,name,statusPreviewable —
--dry-runshows the request without sendingOffline-friendly — sync/search commands can use the local SQLite store when available
Non-interactive — never prompts, every input is a flag
Explicit retries — use
--idempotentonly when an already-existing create should count as success, and--ignore-missingonly when a missing delete target should count as success
Response envelope
Commands that read from the local store or the API wrap output in a provenance envelope:
{
"meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
"results": <data>
}
Parse .results for data and .meta.source to know whether it's live or local. A human-readable N results (live) summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.
Agent Feedback
When you (or the agent) notice something off about this CLI, record it:
google-ads-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
google-ads-pp-cli feedback --stdin < notes.txt
google-ads-pp-cli feedback list --json --limit 10
Entries are stored locally at ~/.google-ads-pp-cli/feedback.jsonl. They are never POSTed unless GOOGLE_ADS_FEEDBACK_ENDPOINT is set AND either --send is passed or GOOGLE_ADS_FEEDBACK_AUTO_SEND=true. Default behavior is local-only.
Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.
Output Delivery
Every command accepts --deliver <sink>. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:
| Sink | Effect |
|---|---|
stdout |
Default; write to stdout only |
file:<path> |
Atomically write output to <path> (tmp + rename) |
webhook:<url> |
POST the output body to the URL (application/json or application/x-ndjson when --compact) |
Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.
Named Profiles
A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.
google-ads-pp-cli profile save briefing --json
google-ads-pp-cli --profile briefing customers-google-ads search mock-value
google-ads-pp-cli profile list --json
google-ads-pp-cli profile show briefing
google-ads-pp-cli profile delete briefing --yes
Explicit flags always win over profile values; profile values win over defaults. agent-context lists all available profiles under available_profiles so introspecting agents discover them at runtime.
Async Jobs
For endpoints that submit long-running work, the generator detects the submit-then-poll pattern (a job_id/task_id/operation_id field in the response plus a sibling status endpoint) and wires up three extra flags on the submitting command:
| Flag | Purpose |
|---|---|
--wait |
Block until the job reaches a terminal status instead of returning the job ID immediately |
--wait-timeout |
Maximum wait duration (default 10m, 0 means no timeout) |
--wait-interval |
Initial poll interval (default 2s; grows with exponential backoff up to 30s) |
Use async submission without --wait when you want to fire-and-forget; use --wait when you want one command to return the finished artifact.
Exit Codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 2 | Usage error (wrong arguments) |
| 3 | Resource not found |
| 4 | Authentication required |
| 5 | API error (upstream issue) |
| 7 | Rate limited (wait and retry) |
| 10 | Config error |
Argument Parsing
Parse $ARGUMENTS:
- Empty,
help, or--help→ showgoogle-ads-pp-cli --helpoutput - Starts with
install→ ends withmcp→ MCP installation; otherwise → see Prerequisites above - Anything else → Direct Use (execute as CLI command with
--agent)
MCP Server Installation
- Install the MCP server:
go install github.com/mvanhorn/printing-press-library/library/marketing/google-ads/cmd/google-ads-pp-mcp@latest - Register with Claude Code:
claude mcp add google-ads-pp-mcp -- google-ads-pp-mcp - Verify:
claude mcp list
Direct Use
- Check if installed:
which google-ads-pp-cliIf not found, offer to install (see Prerequisites at the top of this skill). - Match the user query to the best command from the Unique Capabilities and Command Reference above.
- Execute with the
--agentflag:google-ads-pp-cli <command> [subcommand] [args] --agent - If ambiguous, drill into subcommand help:
google-ads-pp-cli <command> --help.