Update Google Ads entity (adsap_google_update_entity)
Platform: Google Ads · Read or write: Write · Plan: All plans · Consumes a task: Yes · Preview supported: Yes
What it does
Edits an existing Google Ads campaign, ad group, ad or keyword. It changes status, renames a campaign or ad group, sets a campaign daily budget, changes the bidding scheme or targets, edits asset automation, or sets a keyword max CPC. Only the fields you name change. A preview shows the diff before it applies.
Parameters
Descriptions are shortened from the tool schema. Your assistant sees the full text.
| Name | Type | Required | Description |
|---|---|---|---|
entity_type | one of campaign, ad_group, ad, keyword | Yes | Google Ads vocabulary: the middle level is ad_group (not adset). keyword targets one ad-group criterion. |
entity_id | string | Yes | |
ad_account_id | string | Yes | Bare 10-digit Google Ads customer ID (from adsap_google_list_ad_accounts). No dashes, no act_ prefix. |
updates | object | Yes | Only the fields you want to change. At least one is required. |
updates.name | string | No | New name. Campaigns and ad groups only: Google ads have no editable name. |
updates.status | one of PAUSED, ACTIVE | No | ACTIVE maps to Google’s ENABLED. |
updates.daily_budget | number | No | Daily budget in the ACCOUNT CURRENCY as a plain number (e.g. 12.50): NOT micros, NOT cents. Campaigns only: Google budgets live at campaign level (there is no ad-set/ad-group budget). Changing a shared budget affects every campaign using it (a warning is returned). |
updates.cpc_bid | number | No | Per-keyword max CPC in the ACCOUNT CURRENCY (e.g. 1.25). Keywords only. Only used when the campaign bids Manual CPC: automated strategies silently ignore it. |
updates.bidding | object | No | Campaigns only: change the bidding scheme and/or its target values. Portfolio-strategy campaigns are rejected (edit those in Google Ads directly). |
updates.asset_automation | object | No | Asset-automation toggles by key, true = opt in / false = opt out; untouched keys keep their current setting. CAMPAIGNS (PMax + Search only): text_asset_automation, final_url_expansion (both channels); generate_image_enhancement, generate_enhanced_youtube_videos, generate_image_extraction (PMax only). Google rejects turning text_asset_automation OFF while final_url_expansion stays ON: turn both off in the same call. |
dry_run | boolean | No | Preview only: the request is validated and the resolved payload returned, nothing is created or changed. |
Example prompts
- “Raise the daily budget on my Google campaign Summer Sale to 80.”
- “Switch my Search campaign to target CPA at 25 dollars.”
- “Rename the ad group Boots to Winter Boots.”
- “Set the max CPC on this keyword to 1.20.”
Notes
Keyword text cannot be changed here. Keyword bids only apply on Manual CPC campaigns. Portfolio bidding strategies are rejected.
Related tools
adsap_google_set_entity_status: Pause or reactivate one or more Google Ads campaigns, ad groups, ads, or keywords (max 20 per call).
Guide
Read Managing Google Ads in bulk for the workflow around this tool, and the Tool reference for every tool.
Last updated on