Reads
get_google_keyword_ideas requires account_id. Optional arguments are seed_keywords, final_url, language_id, location_ids, limit, login_customer_id, and raw_data. The result key is keyword_ideas. With raw_data: true, the same rows use the key rows.
get_google_keywords lists ad-group keywords. get_google_negative_keywords lists campaign-level negatives. get_google_extensions, get_google_campaign_asset_links, and get_google_ad_group_asset_links list assets and links. An omitted limit on the keyword lists is 25.
Search terms
analyze_search_terms scores the rows you pass. This read leaves Google unqueried, and it leaves the negative-keyword list unchanged.
Each row uses cost and conversions. CPA is cost divided by conversions. When conversions are 0, CPA is the cost. Efficiency uses the signed-in user’s Google target_cpa from KPI targets. When that target is missing, every row is marked efficient and kpi_target is Not set. A row with zero conversions and cost greater than 10 gets the recommendation Add as negative keyword. Every other row gets Keep.
When raw_data is true, the response key is rows and it holds the original rows. When raw_data is omitted, the response key is insights.
Wasted spend
analyze_wasted_spend scores the campaigns you pass. A campaign is wasted when conversions is exactly 0 and spend is greater than 50. That row’s recommendation is Pause or optimize targeting. Every other row is Healthy. The tool leaves the campaign status unchanged.
When raw_data is true, the response key is campaigns and it holds the original rows. When raw_data is omitted, the response key is findings.
Keywords
These writes run when an approved action executes the Google adapter. A plain tools call stays outside that adapter path. Their names sit outside thecreate_google_ prefix, so execution_mode: approval_required leaves them unstaged. See Approvals.
An empty keyword list, a missing ad group, or a missing campaign returns no change.
update_google_campaign_budget takes budget_amount in account currency units and stores micros as Math.round(budget_amount * 1000000). The campaign needs an existing budget resource. A missing budget returns no change.
Assets
Creating an asset returnsasset_resource_name. The campaign and ad group stay unlinked until a later link call.
Sitelink, callout, call, and structured snippet creates use the create_google_ prefix. A request that arrives with execution_mode set to approval_required is staged in Approvals, and that request leaves Google uncalled. The published input schema for those four creates contains the asset fields. Link and remove tools use other names, so that mode leaves them unstaged. They run from an approved action.
Link status accepts
ENABLED, PAUSED, or REMOVED.