google_ ads_ set_ budget_ network_ priorities
Set which networks a campaign budget pays for first, as Google Ads' budget network priorities do (API v26.1).
View as MarkdownSet which networks a campaign budget pays for first, as Google Ads' budget network priorities do (API v26.1). Google's own channels stay on the primary tier; networks listed in secondary (search partners, Display) are served only from what is left, and on Performance Max and Search each can be capped at a share of the budget, 0% to turn it off. Performance Max, Search and Demand Gen daily budgets only; not on custom-period budgets. Replaces this budget's priorities for the campaign's type; reset:true goes back to the account's defaults. Preview reads the campaign, its budget, the campaigns sharing it and the current priorities, and returns planHash; validateOnly asks Google; confirm requires the matching expectedPlanHash. Read them back with google_ads_run_gaql: SELECT campaign_budget.budget_network_settings.settings FROM campaign_budget.
- Source
- Google Ads
- Kind
- Write
- Discovery
- Reachable through
search_toolsandrun_write_tool - Account parameter
customerId- Endpoint
- https:/
/ mcp. getmcpads. com/ google-ads/ mcp
Parameters
| Name | Type | Required | Notes |
|---|---|---|---|
customerId | string | Required | Selected Google Ads customer ID, not the manager account. |
currency | string | Required | Actual account currency as a three-letter ISO code; verified natively before writes. |
campaignId | string | Required | Campaign whose budget gets the priorities (numeric ID of this customer). The setting lives on the budget: a shared budget carries it for every campaign of the same type on it. |
secondary | array | Optional | Networks served only from what Google's own channels (Search, YouTube, Gmail, Discover, Maps) leave of the budget. An empty list puts every network on the same tier. Performance Max and Search accept SEARCH_PARTNER and GOOGLE_DISPLAY; Demand Gen accepts GOOGLE_DISPLAY. |
caps | object | Optional | Share of the whole budget a lower-priority network may spend at most, in percent (10 = 10%, 0 = never). Only for networks listed in secondary; Performance Max and Search only, Google refuses caps on Demand Gen. |
reset | boolean | Optional | true removes this budget's priorities: the account's defaults apply again. Use instead of secondary and caps. |
loginCustomerId | string | Optional | Optional MCC ID; defaults to the selected account's inferred manager. |
testAccountOnly | boolean | Optional | Require customer.test_account=true before writing. Use true when testing on a Google Ads test account. |
validateOnly | boolean | Optional | Ask Google to validate without applying. Takes priority over confirm. |
confirm | boolean | Optional | Apply only when true and expectedPlanHash matches the exact preview. |
expectedPlanHash | string | Optional | SHA-256 planHash from the preview of this exact payload, required for application. |
Calling it
{
"name": "run_write_tool",
"arguments": {
"name": "google_ads_set_budget_network_priorities",
"args": {
"customerId": "<string>",
"currency": "<string>",
"campaignId": "<string>"
}
}
}Manage your ads from your AI assistant
Free with 1 ad account, no card. Pro is free for 7 days.