Back to Details

pp-google-ads

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Google Ads — Printing Press CLI

Google Ads — Printing Press CLI工具

Google Ads API for account discovery, GAQL reporting, campaigns, budgets, assets, conversions, audiences, planning, and billing operations.
基于Google Ads API实现账户发现、GAQL报表、广告系列、预算、资产、转化、受众群体、规划及账单管理等操作。

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.
audience_insights — Google Ads受众洞察操作
  • google-ads-pp-cli audience_insights
    — 列出可请求受众洞察数据的日期范围。
customers — Google Ads客户操作
  • google-ads-pp-cli customers create_customer_client
    — 在管理账户下创建新的客户账户，并返回新创建的客户账户信息。
  • google-ads-pp-cli customers generate_ad_group_themes
    — 根据给定关键词返回建议的广告组列表及建议修改内容（文本、匹配类型）。
  • google-ads-pp-cli customers generate_audience_composition_insights
    — 返回目标受众群体中所包含的属性集合，以及各属性对应的对比指标……
  • google-ads-pp-cli customers generate_audience_overlap_insights
    — 返回受众属性集合，以及这些属性对应的潜在YouTube受众重叠估算值……
  • google-ads-pp-cli customers generate_creator_insights
    — 返回YouTube创作者及频道的洞察信息。
  • google-ads-pp-cli customers generate_insights_finder_report
    — 创建可在Insights Finder工具中查看的已保存报表。
  • google-ads-pp-cli customers generate_keyword_forecast_metrics
    — 返回给定广告系列的关键词预测指标（如展示量、点击量、总成本等）。
  • google-ads-pp-cli customers generate_keyword_historical_metrics
    — 返回关键词历史指标列表。
  • google-ads-pp-cli customers generate_keyword_ideas
    — 返回关键词创意列表。
  • google-ads-pp-cli customers generate_reach_forecast
    — 根据给定的定位/产品组合生成触达预测。
  • google-ads-pp-cli customers generate_shareable_previews
    — 返回请求的可分享预览内容。
  • google-ads-pp-cli customers generate_suggested_targeting_insights
    — 返回与请求受众相关的定位洞察集合（如可定位受众）。
  • google-ads-pp-cli customers generate_targeting_suggestion_metrics
    — 返回可定位受众的潜在触达指标。该方法可帮助解答类似“年龄在……的男性受众数量有多少”这类问题……
  • google-ads-pp-cli customers generate_trending_insights
    — 返回YouTube上热门内容的洞察信息。
  • google-ads-pp-cli customers get_identity_verification
    — 返回身份验证信息。
  • google-ads-pp-cli customers list_accessible_customers
    — 返回调用者可直接访问的客户资源名称。
  • google-ads-pp-cli customers mutate
    — 更新客户账户信息，返回操作状态。
  • google-ads-pp-cli customers remove_campaign_automatically_created_asset
    — 从广告系列中移除自动创建的资产。
  • google-ads-pp-cli customers search_audience_insights_attributes
    — 搜索可用于生成洞察的受众属性。
  • google-ads-pp-cli customers start_identity_verification
    — 针对指定验证程序类型启动身份验证，返回状态信息。
  • google-ads-pp-cli customers suggest_brands
    — 根据前缀返回匹配的品牌列表。
  • google-ads-pp-cli customers suggest_keyword_themes
    — 建议可用于广告投放的关键词主题。
  • google-ads-pp-cli customers suggest_smart_campaign_ad
    — 根据定位等数据点建议与广告资源系列兼容的智能广告系列广告……
  • google-ads-pp-cli customers suggest_smart_campaign_budget_options
    — 返回预算选项建议。
  • google-ads-pp-cli customers suggest_travel_assets
    — 返回旅行资产建议。资产建议基于最佳努力原则返回，不保证……
  • google-ads-pp-cli customers upload_call_conversions
    — 处理给定的通话转化数据。
  • google-ads-pp-cli customers upload_click_conversions
    — 处理给定的点击转化数据。
  • google-ads-pp-cli customers upload_conversion_adjustments
    — 处理给定的转化调整数据。
  • google-ads-pp-cli customers upload_user_data
    — 上传给定的用户数据。
customers_account_budget_proposals — Google Ads客户账户预算提案操作
  • google-ads-pp-cli customers_account_budget_proposals <customerId>
    — 创建、更新或删除账户预算提案，返回操作状态。
customers_account_links — Google Ads客户账户链接操作
  • google-ads-pp-cli customers_account_links create
    — 创建账户链接。
  • google-ads-pp-cli customers_account_links mutate
    — 创建或删除账户链接。从V5版本开始，AccountLinkService.MutateAccountLink不再支持创建操作……
customers_ad_group_ad_labels — Google Ads客户广告组广告标签操作
  • google-ads-pp-cli customers_ad_group_ad_labels <customerId>
    — 创建和删除广告组广告标签，返回操作状态。
customers_ad_group_ads — Google Ads客户广告组广告操作
  • google-ads-pp-cli customers_ad_group_ads mutate
    — 创建、更新或删除广告，返回操作状态。
  • google-ads-pp-cli customers_ad_group_ads remove_automatically_created_assets
    — 从广告中移除自动创建的资产。
customers_ad_group_asset_sets — Google Ads客户广告组资产集操作
  • google-ads-pp-cli customers_ad_group_asset_sets <customerId>
    — 创建或删除广告组资产集，返回操作状态。
customers_ad_group_assets — Google Ads客户广告组资产操作
  • google-ads-pp-cli customers_ad_group_assets <customerId>
    — 创建、更新或删除广告组资产，返回操作状态。
customers_ad_group_bid_modifiers — Google Ads客户广告组出价调整操作
  • google-ads-pp-cli customers_ad_group_bid_modifiers <customerId>
    — 创建、更新或删除广告组出价调整，返回操作状态。
customers_ad_group_criteria — Google Ads客户广告组条件操作
  • google-ads-pp-cli customers_ad_group_criteria <customerId>
    — 创建、更新或删除条件，返回操作状态。
customers_ad_group_criterion_customizers — Google Ads客户广告组条件自定义操作
  • google-ads-pp-cli customers_ad_group_criterion_customizers <customerId>
    — 创建、更新或删除广告组条件自定义项，返回操作状态。
customers_ad_group_criterion_labels — Google Ads客户广告组条件标签操作
  • google-ads-pp-cli customers_ad_group_criterion_labels <customerId>
    — 创建和删除广告组条件标签，返回操作状态。
customers_ad_group_customizers — Google Ads客户广告组自定义操作
  • google-ads-pp-cli customers_ad_group_customizers <customerId>
    — 创建、更新或删除广告组自定义项，返回操作状态。
customers_ad_group_labels — Google Ads客户广告组标签操作
  • google-ads-pp-cli customers_ad_group_labels <customerId>
    — 创建和删除广告组标签，返回操作状态。
customers_ad_groups — Google Ads客户广告组操作
  • google-ads-pp-cli customers_ad_groups <customerId>
    — 创建、更新或删除广告组，返回操作状态。
customers_ad_parameters — Google Ads客户广告参数操作
  • google-ads-pp-cli customers_ad_parameters <customerId>
    — 创建、更新或删除广告参数，返回操作状态。
customers_ads — Google Ads客户广告操作
  • google-ads-pp-cli customers_ads <customerId>
    — 更新广告，返回操作状态。不支持更新TextAd、ExpandedDynamicSearchAd等类型的广告……
customers_asset_generations — Google Ads客户资产生成操作
  • google-ads-pp-cli customers_asset_generations generate_images
    — 使用生成式AI生成可作为广告系列资产的图片。
  • google-ads-pp-cli customers_asset_generations generate_text
    — 使用生成式AI生成可作为广告系列资产的文本。
customers_asset_group_assets — Google Ads客户资产组资产操作
  • google-ads-pp-cli customers_asset_group_assets <customerId>
    — 创建、更新或删除资产组资产，返回操作状态。
customers_asset_group_listing_group_filters — Google Ads客户资产组列表组筛选器操作
  • google-ads-pp-cli customers_asset_group_listing_group_filters <customerId>
    — 创建、更新或删除资产组列表组筛选器，返回操作状态。
customers_asset_group_signals — Google Ads客户资产组信号操作
  • google-ads-pp-cli customers_asset_group_signals <customerId>
    — 创建或删除资产组信号，返回操作状态。
customers_asset_groups — Google Ads客户资产组操作
  • google-ads-pp-cli customers_asset_groups <customerId>
    — 创建、更新或删除资产组，返回操作状态。
customers_asset_set_assets — Google Ads客户资产集资产操作
  • google-ads-pp-cli customers_asset_set_assets <customerId>
    — 创建、更新或删除资产集资产，返回操作状态。
customers_asset_sets — Google Ads客户资产集操作
  • google-ads-pp-cli customers_asset_sets <customerId>
    — 创建、更新或删除资产集，返回操作状态。
customers_assets — Google Ads客户资产操作
  • google-ads-pp-cli customers_assets <customerId>
    — 创建资产，返回操作状态。
customers_audiences — Google Ads客户受众操作
  • google-ads-pp-cli customers_audiences <customerId>
    — 创建受众群体，返回操作状态。
customers_batch_jobs — Google Ads客户批量作业操作
  • google-ads-pp-cli customers_batch_jobs add_operations
    — 向批量作业添加操作。
  • google-ads-pp-cli customers_batch_jobs list_results
    — 返回批量作业结果，作业必须已完成。支持标准列表分页。
  • google-ads-pp-cli customers_batch_jobs mutate
    — 修改批量作业。
  • google-ads-pp-cli customers_batch_jobs run
    — 运行批量作业。Operation.metadata字段类型为BatchJobMetadata。完成后，长时间运行的操作……
customers_bidding_data_exclusions — Google Ads客户出价数据排除操作
  • google-ads-pp-cli customers_bidding_data_exclusions <customerId>
    — 创建、更新或删除数据排除项，返回操作状态。
customers_bidding_seasonality_adjustments — Google Ads客户出价季节性调整操作
  • google-ads-pp-cli customers_bidding_seasonality_adjustments <customerId>
    — 创建、更新或删除季节性调整项，返回操作状态。
customers_bidding_strategies — Google Ads客户出价策略操作
  • google-ads-pp-cli customers_bidding_strategies <customerId>
    — 创建、更新或删除出价策略，返回操作状态。
customers_billing_setups — Google Ads客户账单设置操作
  • google-ads-pp-cli customers_billing_setups <customerId>
    — 创建账单设置或取消现有账单设置。
customers_campaign_asset_sets — Google Ads客户广告系列资产集操作
  • google-ads-pp-cli customers_campaign_asset_sets <customerId>
    — 创建、更新或删除广告系列资产集，返回操作状态。
customers_campaign_assets — Google Ads客户广告系列资产操作
  • google-ads-pp-cli customers_campaign_assets <customerId>
    — 创建、更新或删除广告系列资产，返回操作状态。
customers_campaign_bid_modifiers — Google Ads客户广告系列出价调整操作
  • google-ads-pp-cli customers_campaign_bid_modifiers <customerId>
    — 创建、更新或删除广告系列出价调整，返回操作状态。
customers_campaign_budgets — Google Ads客户广告系列预算操作
  • google-ads-pp-cli customers_campaign_budgets <customerId>
    — 创建、更新或删除广告系列预算，返回操作状态。
customers_campaign_conversion_goals — Google Ads客户广告系列转化目标操作
  • google-ads-pp-cli customers_campaign_conversion_goals <customerId>
    — 创建、更新或删除广告系列转化目标，返回操作状态。
customers_campaign_criteria — Google Ads客户广告系列条件操作
  • google-ads-pp-cli customers_campaign_criteria <customerId>
    — 创建、更新或删除条件，返回操作状态。
customers_campaign_customizers — Google Ads客户广告系列自定义操作
  • google-ads-pp-cli customers_campaign_customizers <customerId>
    — 创建、更新或删除广告系列自定义项，返回操作状态。
customers_campaign_drafts — Google Ads客户广告系列草稿操作
  • google-ads-pp-cli customers_campaign_drafts list_async_errors
    — 返回CampaignDraft推广过程中发生的所有错误。在广告系列草稿完成前调用会抛出错误……
  • google-ads-pp-cli customers_campaign_drafts mutate
    — 创建、更新或删除广告系列草稿，返回操作状态。
  • google-ads-pp-cli customers_campaign_drafts promote
    — 将草稿中的更改推广回基础广告系列。该方法返回一个长时间运行的操作（LRO）……
customers_campaign_goal_configs — Google Ads客户广告系列目标配置操作
  • google-ads-pp-cli customers_campaign_goal_configs <customerId>
    — 创建或更新广告系列目标配置。
customers_campaign_groups — Google Ads客户广告系列组操作
  • google-ads-pp-cli customers_campaign_groups <customerId>
    — 创建、更新或删除广告系列组，返回操作状态。
customers_campaign_labels — Google Ads客户广告系列标签操作
  • google-ads-pp-cli customers_campaign_labels <customerId>
    — 创建和删除广告系列与标签的关联关系，返回操作状态。
customers_campaign_lifecycle_goal — Google Ads客户广告系列生命周期目标操作
  • google-ads-pp-cli customers_campaign_lifecycle_goal <customerId>
    — 处理给定的广告系列生命周期配置。
customers_campaign_shared_sets — Google Ads客户广告系列共享集操作
  • google-ads-pp-cli customers_campaign_shared_sets <customerId>
    — 创建或删除广告系列共享集，返回操作状态。
customers_campaigns — Google Ads客户广告系列操作
  • google-ads-pp-cli customers_campaigns enable_pmax_brand_guidelines
    — 为Performance Max广告系列启用品牌指南。
  • google-ads-pp-cli customers_campaigns mutate
    — 创建、更新或删除广告系列，返回操作状态。
customers_conversion_actions — Google Ads客户转化操作
  • google-ads-pp-cli customers_conversion_actions <customerId>
    — 创建、更新或删除转化操作，返回操作状态。
customers_conversion_custom_variables — Google Ads客户转化自定义变量操作
  • google-ads-pp-cli customers_conversion_custom_variables <customerId>
    — 创建或更新转化自定义变量，返回操作状态。
customers_conversion_goal_campaign_configs — Google Ads客户转化目标广告系列配置操作
  • google-ads-pp-cli customers_conversion_goal_campaign_configs <customerId>
    — 创建、更新或删除转化目标广告系列配置，返回操作状态。
customers_conversion_value_rule_sets — Google Ads客户转化价值规则集操作
  • google-ads-pp-cli customers_conversion_value_rule_sets <customerId>
    — 创建、更新或删除转化价值规则集，返回操作状态。
customers_conversion_value_rules — Google Ads客户转化价值规则操作
  • google-ads-pp-cli customers_conversion_value_rules <customerId>
    — 创建、更新或删除转化价值规则，返回操作状态。
customers_custom_audiences — Google Ads客户自定义受众操作
  • google-ads-pp-cli customers_custom_audiences <customerId>
    — 创建或更新自定义受众，返回操作状态。
customers_custom_conversion_goals — Google Ads客户自定义转化目标操作
  • google-ads-pp-cli customers_custom_conversion_goals <customerId>
    — 创建、更新或删除自定义转化目标，返回操作状态。
customers_custom_interests — Google Ads客户自定义兴趣操作
  • google-ads-pp-cli customers_custom_interests <customerId>
    — 创建或更新自定义兴趣，返回操作状态。
customers_customer_asset_sets — Google Ads客户账户资产集操作
  • google-ads-pp-cli customers_customer_asset_sets <customerId>
    — 创建或删除客户账户资产集，返回操作状态。
customers_customer_assets — Google Ads客户账户资产操作
  • google-ads-pp-cli customers_customer_assets <customerId>
    — 创建、更新或删除客户账户资产，返回操作状态。
customers_customer_client_links — Google Ads客户账户客户链接操作
  • google-ads-pp-cli customers_customer_client_links <customerId>
    — 创建或更新客户账户客户链接，返回操作状态。
customers_customer_conversion_goals — Google Ads客户账户转化目标操作
  • google-ads-pp-cli customers_customer_conversion_goals <customerId>
    — 创建、更新或删除客户账户转化目标，返回操作状态。
customers_customer_customizers — Google Ads客户账户自定义操作
  • google-ads-pp-cli customers_customer_customizers <customerId>
    — 创建、更新或删除客户账户自定义项，返回操作状态。
customers_customer_labels — Google Ads客户账户标签操作
  • google-ads-pp-cli customers_customer_labels <customerId>
    — 创建和删除客户账户与标签的关联关系，返回操作状态。
customers_customer_lifecycle_goal — Google Ads客户账户生命周期目标操作
  • google-ads-pp-cli customers_customer_lifecycle_goal <customerId>
    — 处理给定的客户账户生命周期配置。
customers_customer_manager_links — Google Ads客户账户管理链接操作
  • google-ads-pp-cli customers_customer_manager_links move_manager_link
    — 将客户账户迁移到新的管理账户。这简化了需要两个操作的复杂请求……
  • google-ads-pp-cli customers_customer_manager_links mutate
    — 更新客户账户管理链接，返回操作状态。
customers_customer_negative_criteria — Google Ads客户账户否定条件操作
  • google-ads-pp-cli customers_customer_negative_criteria <customerId>
    — 创建或删除否定条件，返回操作状态。
customers_customer_sk_ad_network_conversion_value_schemas — Google Ads客户账户SkAdNetwork转化价值模式操作
  • google-ads-pp-cli customers_customer_sk_ad_network_conversion_value_schemas <customerId>
    — 创建或更新CustomerSkAdNetworkConversionValueSchema。
customers_customer_user_access_invitations — Google Ads客户账户用户访问邀请操作
  • google-ads-pp-cli customers_customer_user_access_invitations <customerId>
    — 创建或删除访问邀请。
customers_customer_user_accesses — Google Ads客户账户用户访问权限操作
  • google-ads-pp-cli customers_customer_user_accesses <customerId>
    — 更新或删除用户在指定客户账户上的权限，返回操作状态。
customers_customizer_attributes — Google Ads客户自定义属性操作
  • google-ads-pp-cli customers_customizer_attributes <customerId>
    — 创建、更新或删除自定义属性，返回操作状态。
customers_data_links — Google Ads客户数据链接操作
  • google-ads-pp-cli customers_data_links create
    — 创建数据链接。请求的Google Ads账户名称和账户ID将与第三方共享（如……
  • google-ads-pp-cli customers_data_links remove
    — 删除数据链接。
  • google-ads-pp-cli customers_data_links update
    — 更新数据链接。
customers_experiment_arms — Google Ads客户实验分支操作
  • google-ads-pp-cli customers_experiment_arms <customerId>
    — 创建、更新或删除实验分支，返回操作状态。
customers_experiments — Google Ads客户实验操作
  • google-ads-pp-cli customers_experiments end_experiment
    — 立即结束实验，更改实验的计划结束日期，无需等待当日结束。结束……
  • google-ads-pp-cli customers_experiments graduate_experiment
    — 将实验升级为正式广告系列。
  • google-ads-pp-cli customers_experiments list_experiment_async_errors
    — 返回上次实验更新（调度或推广）过程中发生的所有错误。支持……
  • google-ads-pp-cli customers_experiments mutate
    — 创建、更新或删除实验，返回操作状态。
  • google-ads-pp-cli customers_experiments promote_experiment
    — 推广试用广告系列，将试用广告系列中的更改应用到基础广告系列。该方法返回一个……
  • google-ads-pp-cli customers_experiments schedule_experiment
    — 调度实验。设计中的广告系列将转换为真实广告系列（称为实验……
customers_goals — Google Ads客户目标操作
  • google-ads-pp-cli customers_goals <customerId>
    — 创建或更新目标。
customers_google_ads — Google Ads客户核心操作
  • google-ads-pp-cli customers_google_ads mutate
    — 创建、更新或删除资源。该方法支持多种资源类型的原子事务……
  • google-ads-pp-cli customers_google_ads search
    — 返回所有匹配搜索查询的行。
  • google-ads-pp-cli customers_google_ads search_stream
    — 返回所有匹配搜索流查询的行。
customers_invoices — Google Ads客户发票操作
  • google-ads-pp-cli customers_invoices <customerId>
    — 返回给定月份与账单设置关联的所有发票。
customers_keyword_plan_ad_group_keywords — Google Ads客户关键词计划广告组关键词操作
  • google-ads-pp-cli customers_keyword_plan_ad_group_keywords <customerId>
    — 创建、更新或删除关键词计划广告组关键词，返回操作状态。
customers_keyword_plan_ad_groups — Google Ads客户关键词计划广告组操作
  • google-ads-pp-cli customers_keyword_plan_ad_groups <customerId>
    — 创建、更新或删除关键词计划广告组，返回操作状态。
customers_keyword_plan_campaign_keywords — Google Ads客户关键词计划广告系列关键词操作
  • google-ads-pp-cli customers_keyword_plan_campaign_keywords <customerId>
    — 创建、更新或删除关键词计划广告系列关键词，返回操作状态。
customers_keyword_plan_campaigns — Google Ads客户关键词计划广告系列操作
  • google-ads-pp-cli customers_keyword_plan_campaigns <customerId>
    — 创建、更新或删除关键词计划广告系列，返回操作状态。
customers_keyword_plans — Google Ads客户关键词计划操作
  • google-ads-pp-cli customers_keyword_plans <customerId>
    — 创建、更新或删除关键词计划，返回操作状态。
customers_labels — Google Ads客户标签操作
  • google-ads-pp-cli customers_labels <customerId>
    — 创建、更新或删除标签，返回操作状态。
customers_local_services — Google Ads客户本地服务操作
  • google-ads-pp-cli customers_local_services <customerId>
    — 将本地服务潜在客户对话资源附加到本地服务潜在客户资源的RPC接口。
customers_local_services_leads — Google Ads客户本地服务潜在客户操作
  • google-ads-pp-cli customers_local_services_leads <resourceName>
    — 提供本地服务潜在客户资源反馈的RPC接口。
customers_offline_user_data_jobs — Google Ads客户离线用户数据作业操作
  • google-ads-pp-cli customers_offline_user_data_jobs add_operations
    — 向离线用户数据作业添加操作。
  • google-ads-pp-cli customers_offline_user_data_jobs create
    — 创建离线用户数据作业。
  • google-ads-pp-cli customers_offline_user_data_jobs run
    — 运行离线用户数据作业。完成后，长时间运行的操作将包含处理结果或……
customers_operations — Google Ads客户操作管理
  • google-ads-pp-cli customers_operations cancel
    — 启动对长时间运行操作的异步取消。服务器会尽力取消……
  • google-ads-pp-cli customers_operations delete
    — 删除长时间运行的操作。该方法表示客户端不再对操作结果感兴趣……
  • google-ads-pp-cli customers_operations get
    — 获取长时间运行操作的最新状态。客户端可以使用此方法轮询操作结果……
  • google-ads-pp-cli customers_operations list
    — 列出与请求中指定筛选条件匹配的操作。如果服务器不支持此方法，将……
  • google-ads-pp-cli customers_operations wait
    — 等待指定的长时间运行操作完成或达到指定超时时间，返回……
customers_payments_accounts — Google Ads客户支付账户操作
  • google-ads-pp-cli customers_payments_accounts <customerId>
    — 返回登录客户ID与指定服务客户之间所有管理账户关联的所有支付账户……
customers_product_link_invitations — Google Ads客户产品链接邀请操作
  • google-ads-pp-cli customers_product_link_invitations create
    — 创建产品链接邀请。
  • google-ads-pp-cli customers_product_link_invitations remove
    — 删除产品链接邀请。
  • google-ads-pp-cli customers_product_link_invitations update
    — 更新产品链接邀请。
customers_product_links — Google Ads客户产品链接操作
  • google-ads-pp-cli customers_product_links create
    — 创建产品链接。
  • google-ads-pp-cli customers_product_links remove
    — 删除产品链接。
customers_recommendation_subscriptions — Google Ads客户推荐订阅操作
  • google-ads-pp-cli customers_recommendation_subscriptions <customerId>
    — 使用相应的应用参数修改给定的订阅。
customers_recommendations — Google Ads客户推荐操作
  • google-ads-pp-cli customers_recommendations apply
    — 使用相应的应用参数应用给定的推荐。
  • google-ads-pp-cli customers_recommendations dismiss
    — 驳回给定的推荐。
  • google-ads-pp-cli customers_recommendations generate
    — 根据请求的推荐类型生成推荐。
customers_remarketing_actions — Google Ads客户再营销操作
  • google-ads-pp-cli customers_remarketing_actions <customerId>
    — 创建或更新再营销操作，返回操作状态。
customers_shared_criteria — Google Ads客户共享条件操作
  • google-ads-pp-cli customers_shared_criteria <customerId>
    — 创建或删除共享条件，返回操作状态。
customers_shared_sets — Google Ads客户共享集操作
  • google-ads-pp-cli customers_shared_sets <customerId>
    — 创建、更新或删除共享集，返回操作状态。
customers_smart_campaign_settings — Google Ads客户智能广告系列设置操作
  • google-ads-pp-cli customers_smart_campaign_settings get_smart_campaign_status
    — 返回请求的智能广告系列状态。
  • google-ads-pp-cli customers_smart_campaign_settings mutate
    — 更新广告系列的智能广告系列设置。
customers_third_party_app_analytics_links — Google Ads客户第三方应用分析链接操作
  • google-ads-pp-cli customers_third_party_app_analytics_links <resourceName>
    — 重新生成ThirdPartyAppAnalyticsLink.shareable_link_id，在设置时应提供给第三方……
customers_user_list_customer_types — Google Ads客户用户列表客户类型操作
  • google-ads-pp-cli customers_user_list_customer_types <customerId>
    — 添加或移除用户列表客户类型，返回操作状态。
customers_user_lists — Google Ads客户用户列表操作
  • google-ads-pp-cli customers_user_lists <customerId>
    — 创建或更新用户列表，返回操作状态。
geo_target_constants — Google Ads地理位置定位常量操作
  • google-ads-pp-cli geo_target_constants
    — 根据位置名称或资源名称返回GeoTargetConstant建议。
google_ads — Google Ads全局操作
  • google-ads-pp-cli google_ads generate_conversion_rates
    — 返回支持规划产品的转化率建议集合。
  • google-ads-pp-cli google_ads list_plannable_locations
    — 返回可规划位置列表（如国家/地区）。
  • google-ads-pp-cli google_ads list_plannable_products
    — 返回各位置可规划的YouTube广告格式列表及允许的定位方式。
  • google-ads-pp-cli google_ads list_plannable_user_interests
    — 返回可规划的用户兴趣列表。可规划用户兴趣是指可在触达……中定位的兴趣。
  • google-ads-pp-cli google_ads list_plannable_user_lists
    — 返回可规划的用户列表及其可规划状态。用户列表可能因多种原因无法规划……
google_ads_fields — Google Ads字段操作
  • google-ads-pp-cli google_ads_fields get
    — 仅返回请求的字段。
  • google-ads-pp-cli google_ads_fields search
    — 返回所有匹配搜索查询的字段。
keyword_theme_constants — Google Ads关键词主题常量操作
  • google-ads-pp-cli keyword_theme_constants
    — 根据关键词主题返回KeywordThemeConstant建议。

Finding the right command

查找合适的命令

When you know what you want to do but not which command does it, ask the CLI directly:
bash
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.
当您知道要执行的操作但不知道对应的命令时，可以直接询问CLI：
bash
google-ads-pp-cli which "<用您自己的语言描述功能>"
which
命令会将自然语言描述的功能查询解析为CLI精选功能索引中最匹配的命令。退出码
0
表示至少有一个匹配项；退出码
2
表示没有确定的匹配项——此时请使用
--help
或更精确的查询。

Auth Setup

身份验证设置

Store your OAuth2 access token:
bash
google-ads-pp-cli auth set-token YOUR_TOKEN_HERE
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.
存储您的OAuth2访问令牌：
bash
google-ads-pp-cli auth set-token YOUR_TOKEN_HERE
同时设置
GOOGLE_ADS_DEVELOPER_TOKEN
；通过管理账户调用时，请设置
GOOGLE_ADS_LOGIN_CUSTOMER_ID
。
运行
google-ads-pp-cli doctor
验证设置是否正确。

Agent Mode

代理模式

Add 
--agent
to any command. Expands to: 
--json --compact --no-input --no-color --yes
.
  • Pipeable — JSON on stdout, errors on stderr
  • Filterable — 
    --select
    keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
    bash
    google-ads-pp-cli customers_google_ads search mock-value --agent --select id,name,status
  • Previewable — 
    --dry-run
    shows the request without sending
  • Offline-friendly — sync/search commands can use the local SQLite store when available
  • Non-interactive — never prompts, every input is a flag
  • Explicit retries — use 
    --idempotent
    only when an already-existing create should count as success, and 
    --ignore-missing
    only when a missing delete target should count as success
在任意命令后添加
--agent
参数。等效于：
--json --compact --no-input --no-color --yes
。
  • 可管道传输 — 标准输出为JSON格式，错误信息输出到标准错误
  • 可筛选 — 
    --select
    参数保留字段子集。点路径可深入嵌套结构；数组会遍历每个元素。对于冗长的API，这是缩小上下文范围的关键：
    bash
    google-ads-pp-cli customers_google_ads search mock-value --agent --select id,name,status
  • 可预览 — 
    --dry-run
    参数显示请求内容但不发送
  • 离线友好 — 同步/搜索命令在本地SQLite存储可用时可使用该存储
  • 非交互式 — 从不提示，所有输入均通过标志参数提供
  • 显式重试 — 仅当已存在的创建操作应视为成功时使用
    --idempotent
    参数，仅当缺失的删除目标应视为成功时使用
    --ignore-missing
    参数

Response envelope

响应信封

Commands that read from the local store or the API wrap output in a provenance envelope:
json
{
  "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.
从本地存储或API读取数据的命令会将输出包装在来源信封中：
json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}
解析
.results
获取数据，通过
.meta.source
了解数据是实时的还是本地的。仅当标准输出为终端时，才会在标准错误中打印人类可读的
N results (live)
摘要——管道/代理消费者仅会在标准输出中获取纯JSON数据。

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.
当您（或代理）发现此CLI存在问题时，请记录反馈：
google-ads-pp-cli feedback "--since参数是包含性的，但文档说是排他性的"
google-ads-pp-cli feedback --stdin < notes.txt
google-ads-pp-cli feedback list --json --limit 10
反馈条目存储在本地
~/.google-ads-pp-cli/feedback.jsonl
文件中。除非设置了
GOOGLE_ADS_FEEDBACK_ENDPOINT
且传递了
--send
参数或设置了
GOOGLE_ADS_FEEDBACK_AUTO_SEND=true
，否则不会自动发送。默认行为仅存储在本地。
请写下让您感到意外的内容，而不是正式的错误报告。简短、具体、单行描述：这样的反馈更有价值。

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:
SinkEffect
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.
每个命令都支持
--deliver <sink>
参数。输出会除了（或代替）标准输出外，发送到指定的接收器，以便代理无需手动管道即可路由命令结果。支持三种接收器：
接收器效果
stdout
默认值；仅输出到标准输出
file:<path>
原子性地将输出写入
<path>
（先写入临时文件再重命名）
webhook:<url>
将输出主体POST到指定URL（当使用
--compact
时为
application/json
或
application/x-ndjson
格式）
未知的协议会被拒绝，并返回结构化错误，列出支持的接收器类型。Webhook失败时会返回非零退出码，并在标准错误中记录URL和HTTP状态。

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.
配置文件是一组保存的标志值，可在多次调用中重复使用。当调度代理每次运行都使用相同配置调用同一命令时，可使用此功能——即HeyGen的“Beacon”模式。
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
显式标志始终优先于配置文件值；配置文件值优先于默认值。
agent-context
命令会在
available_profiles
下列出所有可用配置文件，以便内省代理在运行时发现它们。

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:
FlagPurpose
--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.
对于提交长时间运行任务的端点，生成器会检测提交-轮询模式（响应中包含
job_id
/
task_id
/
operation_id
字段以及对应的状态端点），并在提交命令上添加三个额外标志：
标志用途
--wait
阻塞直到作业达到终端状态，而不是立即返回作业ID
--wait-timeout
最大等待时长（默认10分钟，0表示无超时）
--wait-interval
初始轮询间隔（默认2秒；随指数退避增长至最多30秒）
当您想触发后即无需关注时，使用不带
--wait
的异步提交；当您希望一个命令返回最终结果时，使用
--wait
。

Exit Codes

退出码

CodeMeaning
0Success
2Usage error (wrong arguments)
3Resource not found
4Authentication required
5API error (upstream issue)
7Rate limited (wait and retry)
10Config error
代码含义
0成功
2使用错误（参数错误）
3资源未找到
4需要身份验证
5API错误（上游问题）
7速率限制（请等待并重试）
10配置错误

Argument Parsing

参数解析

Parse 
$ARGUMENTS
:
  1. Empty, 
    help
    , or 
    --help
     → show 
    google-ads-pp-cli --help
    output
  2. Starts with 
    install
     → ends with 
    mcp
    → MCP installation; otherwise → CLI installation
  3. Anything else → Direct Use (execute as CLI command with 
    --agent
    )
解析
$ARGUMENTS
的逻辑：
  1. 为空、
    help
    或
    --help
     → 显示
    google-ads-pp-cli --help
    输出
  2. 以
    install
    开头     → 以
    mcp
    结尾 → MCP安装；否则 → CLI安装
  3. 其他情况 → 直接使用（以
    --agent
    标志执行CLI命令）

CLI Installation

CLI安装

  1. Check Go is installed: 
    go version
    (requires Go 1.26.3 or newer)
  2. Install:
    bash
    go install github.com/mvanhorn/printing-press-library/library/marketing/google-ads/cmd/google-ads-pp-cli@latest
  3. Verify: 
    google-ads-pp-cli --version
  4. Ensure 
    $GOPATH/bin
    (or 
    $HOME/go/bin
    ) is on 
    $PATH
    .
  1. 检查Go是否安装：
    go version
    （需要Go 1.26.3或更高版本）
  2. 安装：
    bash
    go install github.com/mvanhorn/printing-press-library/library/marketing/google-ads/cmd/google-ads-pp-cli@latest
  3. 验证：
    google-ads-pp-cli --version
  4. 确保
    $GOPATH/bin
    （或
    $HOME/go/bin
    ）在
    $PATH
    环境变量中。

MCP Server Installation

MCP服务器安装

  1. Install the MCP server:
    bash
    go install github.com/mvanhorn/printing-press-library/library/marketing/google-ads/cmd/google-ads-pp-mcp@latest
  2. Register with Claude Code:
    bash
    claude mcp add google-ads-pp-mcp -- google-ads-pp-mcp
  3. Verify: 
    claude mcp list
  1. 安装MCP服务器：
    bash
    go install github.com/mvanhorn/printing-press-library/library/marketing/google-ads/cmd/google-ads-pp-mcp@latest
  2. 在Claude Code中注册：
    bash
    claude mcp add google-ads-pp-mcp -- google-ads-pp-mcp
  3. 验证：
    claude mcp list

Direct Use

直接使用

  1. Check if installed: 
    which google-ads-pp-cli
    If not found, offer to install (see CLI Installation above).
  2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
  3. Execute with the 
    --agent
    flag:
    bash
    google-ads-pp-cli <command> [subcommand] [args] --agent
  4. If ambiguous, drill into subcommand help: 
    google-ads-pp-cli <command> --help
    .
  1. 检查是否已安装：
    which google-ads-pp-cli
    如果未找到，提供安装选项（请参阅上述CLI安装步骤）。
  2. 将用户查询与上述独特功能和命令参考中最匹配的命令进行匹配。
  3. 使用
    --agent
    标志执行：
    bash
    google-ads-pp-cli <command> [subcommand] [args] --agent
  4. 如果存在歧义，查看子命令帮助：
    google-ads-pp-cli <command> --help
    。