Marketing

Google Ads

pp-google-ads

Google Ads API for account discovery, GAQL reporting, campaigns, budgets, assets, conversions, audiences, planning, and billing operations.

Printed by @cathrynlavery (Cathryn Lavery)

Install

npx — recommended

npx -y @mvanhorn/printing-press-library install google-ads

Installs the CLI binary and the agent skill (Claude Code, Codex, Cursor, Gemini CLI, Copilot, and more). Add --cli-only or --skill-only for one half. Requires Node.

Hermes

hermes skills install mvanhorn/printing-press-library/cli-skills/pp-google-ads --force

From the Hermes CLI. Inside a chat session use /skills install with the same path.

OpenClaw

Install the pp-google-ads skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-google-ads. The skill defines how its required CLI can be installed.

Paste this to your OpenClaw agent — the skill describes how to install its CLI.

Claude Desktop

This CLI ships an MCPB bundle. Download the latest release .mcpb and double-click it — Claude Desktop walks you through the install.

View source on GitHub →

Google Ads API for account discovery, GAQL reporting, campaigns, budgets, assets, conversions, audiences, planning, and billing operations.

Learn more at Google Ads.

Quick Start

1. Install

See Install above.

2. Set Up Credentials

Google Ads requires an OAuth2 access token with the https://www.googleapis.com/auth/adwords scope and a Google Ads developer token. Store the OAuth token:

google-ads-pp-cli auth set-token YOUR_TOKEN_HERE

Or set it via environment variable:

export GOOGLE_ADS_ACCESS_TOKEN="your-token-here"
export GOOGLE_ADS_DEVELOPER_TOKEN="your-developer-token-here"
# Optional, for manager-account calls:
export GOOGLE_ADS_LOGIN_CUSTOMER_ID="1234567890"

3. Verify Setup

google-ads-pp-cli doctor

This checks your configuration and credentials.

4. Try Your First Command

google-ads-pp-cli customers_google_ads search mock-value

Usage

Run google-ads-pp-cli --help for the full command reference and flag list.

Commands

audience_insights

Google Ads audience insights operations

google-ads-pp-cli audience_insights list_insights_eligible_dates - 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 attribute's share of the audience with its share of a baseline audience.
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 reach and that of a given input attribute.
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 18+ interested in Camping can be reached on YouTube?"
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 the business to advertise.
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 that all possible asset types will be returned for any given hotel property.
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 mutate - 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. Use AccountLinkService.CreateAccountLink instead.

customers_ad_group_ad_labels

Google Ads customers ad group ad labels operations

google-ads-pp-cli customers_ad_group_ad_labels mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - Creates, updates, or removes ad parameters. Operation statuses are returned.

customers_ads

Google Ads customers ads operations

google-ads-pp-cli customers_ads mutate - Updates ads. Operation statuses are returned. Updating ads is not supported for TextAd, ExpandedDynamicSearchAd, GmailAd and ImageAd.

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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - Creates, updates or removes asset sets. Operation statuses are returned.

customers_assets

Google Ads customers assets operations

google-ads-pp-cli customers_assets mutate - Creates assets. Operation statuses are returned.

customers_audiences

Google Ads customers audiences operations

google-ads-pp-cli customers_audiences mutate - 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 will not contain errors or a response. Instead, use ListBatchJobResults to get the results of the job.

customers_bidding_data_exclusions

Google Ads customers bidding data exclusions operations

google-ads-pp-cli customers_bidding_data_exclusions mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 promoted. Supports standard list paging.
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) indicating if the Promote is done. Use google.longrunning.Operations.GetOperation to poll the LRO until it is done. Only a done status is returned in the response. See the status in the Campaign Draft resource

customers_campaign_goal_configs

Google Ads customers campaign goal configs operations

google-ads-pp-cli customers_campaign_goal_configs mutate - Create or update campaign goal configs.

customers_campaign_groups

Google Ads customers campaign groups operations

google-ads-pp-cli customers_campaign_groups mutate - 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 mutate - 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 configure_campaign_lifecycle_goals - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 configure_customer_lifecycle_goals - 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 to move a client customer to a new manager, for example: 1. Update operation with Status INACTIVE (previous manager) and, 2. Update operation with Status ACTIVE (new manager).
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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 as YouTube creators for video links) to whom you are creating the link with.
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 mutate - 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 date is updated to be the time of the request.
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 standard list paging.
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 long running operation that tracks the promotion of the experiment campaign. If it fails, a list of errors can be retrieved using the ListExperimentAsyncErrors method. The operation's metadata will be a s
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 campaign) that will begin serving ads if successfully created. The experiment is scheduled immediately with status INITIALIZING. This method returns a long running operation that tracks the forking of the in des

customers_goals

Google Ads customers goals operations

google-ads-pp-cli customers_goals mutate - 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. For example, you can atomically create a campaign and a campaign budget, or perform up to thousands of mutates atomically. This method is essentially a wrapper around a series of mutate methods. The only f
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 list - 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 mutate - 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 mutate - 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 mutate - 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 mutate - 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 mutate - Creates, updates, or removes keyword plans. Operation statuses are returned.

customers_labels

Google Ads customers labels operations

google-ads-pp-cli customers_labels mutate - 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 append_lead_conversation - 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 provide_lead_feedback - 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 failure information, if any.

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 operation, but success is not guaranteed. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED. Clients can use Operations.GetOperation or other methods to check whether the cancel
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 result. It does not cancel the operation. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
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 intervals as recommended by the API service.
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 returns UNIMPLEMENTED.
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 latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does

customers_payments_accounts

Google Ads customers payments accounts operations

google-ads-pp-cli customers_payments_accounts list - Returns all payments accounts associated with all managers between the login customer ID and specified serving customer in the hierarchy, inclusive.

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 mutate_recommendation_subscription - 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 mutate - 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 mutate - 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 mutate - 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 regenerate_shareable_link_id - Regenerate ThirdPartyAppAnalyticsLink.shareable_link_id that should be provided to the third party when setting up app analytics.

customers_user_list_customer_types

Google Ads customers user list customer types operations

google-ads-pp-cli customers_user_list_customer_types mutate - 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 mutate - 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 suggest - 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 forecast using ReachPlanService.GenerateReachForecast.
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 of reasons, including: - They are less than 10 days old. - They have a membership lifespan that is less than 30 days - They have less than 10,000 or more than 700,000 users.

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 suggest - Returns KeywordThemeConstant suggestions by keyword themes.

Output Formats

# Human-readable table (default in terminal, JSON when piped)
google-ads-pp-cli customers_google_ads search mock-value

# JSON for scripting and agents
google-ads-pp-cli customers_google_ads search mock-value --json

# Filter to specific fields
google-ads-pp-cli customers_google_ads search mock-value --json --select id,name,status

# Dry run — show the request without sending
google-ads-pp-cli customers_google_ads search mock-value --dry-run

# Agent mode — JSON + compact + no prompts in one flag
google-ads-pp-cli customers_google_ads search mock-value --agent

Agent Usage

This CLI is designed for AI agent consumption:

Non-interactive - never prompts, every input is a flag
Pipeable - --json output to stdout, errors to stderr
Filterable - --select id,name returns only fields you need
Previewable - --dry-run shows the request without sending
Explicit retries - add --idempotent to create retries and --ignore-missing to delete retries when a no-op success is acceptable
Confirmable - --yes for explicit confirmation of destructive actions
Piped input - write commands can accept structured input when their help lists --stdin
Offline-friendly - sync/search commands can use the local SQLite store when available
Agent-safe by default - no colors or formatting unless --human-friendly is set

Exit codes: 0 success, 2 usage error, 3 not found, 4 auth error, 5 API error, 7 rate limited, 10 config error.

Health Check

google-ads-pp-cli doctor

Verifies configuration, credentials, and connectivity to the API.

Configuration

Config file: ~/.config/google-ads-pp-cli/config.toml

Environment variables:

Name	Kind	Required	Description
`GOOGLE_ADS_ACCESS_TOKEN`	per_call	Yes	Set to your API credential.
`GOOGLE_ADS_DEVELOPER_TOKEN`	per_call	Yes	Set to your API credential.
`GOOGLE_ADS_LOGIN_CUSTOMER_ID`	per_call	No	Optional manager account ID sent as the login-customer-id header.

Troubleshooting

Authentication errors (exit code 4)

Run google-ads-pp-cli doctor to check credentials
Verify the environment variables are set: echo $GOOGLE_ADS_ACCESS_TOKEN and echo $GOOGLE_ADS_DEVELOPER_TOKEN Not found errors (exit code 3)
Check the resource ID is correct
Run the list command to see available items

Generated by CLI Printing Press