gum logofield manual
ServicesGoogle AdsGoogle APIs for agents and terminals

Google Ads

Google Ads has 3 operations in gum's generated catalog. Start with search when you know the task, use describe to inspect request fields and scopes, then dispatch through the command that matches the operation risk class.

Count Value
Family Ads and maps
Operations 3
Risk classes 3 read
Auth strategies 3 byo_oauth

Start here

bash
gum search "google ads"
gum describe googleads.keywordPlanIdeas.generateKeywordForecastMetrics
gum read googleads.keywordPlanIdeas.generateKeywordForecastMetrics --args '{"customerId":"<customerId>","keywords":[]}' --output json

Operations

Operation Risk Auth Summary
googleads.keywordPlanIdeas.generateKeywordForecastMetrics read byo_oauth Forecast clicks, impressions, cost, and CTR for a list of keywords over a future date range at a given max CPC. Needs keywords; for full campaign control pass a raw body.
googleads.keywordPlanIdeas.generateKeywordHistoricalMetrics read byo_oauth Fetch historical metrics (average monthly searches, per-month search volumes, competition index, top-of-page bid ranges) for a fixed list of keywords. Needs keywords.
googleads.keywordPlanIdeas.generateKeywordIdeas read byo_oauth Discover new keyword ideas with monthly search volume, competition, and top-of-page bid ranges from a seed of keywords and/or a landing-page URL. Needs keywords and/or url.

Next