Get Google Ads budget boundaries
<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>
Reads the daily budget range Google accepts for a campaign type and currency, so you can validate a budget before you create a campaign.
The numbers come from a fixed table rather than from Google, because Google does not publish them as a queryable resource. They change rarely. min_daily_budget_micros is the same floor the create, update, and bulk-budget endpoints enforce, so a budget that passes here is accepted there.
You do not need a connected Google Ads account to call this, which is what lets you show a budget slider before the account exists. An unrecognized currency_code or campaign_type is not rejected: you get the US dollar and Smart campaign defaults back, with the values you sent echoed in currency_code and campaign_type. Compare those two fields against what you sent if you need to know that happened.
<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>
Path parameters
ID of the app you are planning a Google Ads campaign for.
ID of the app you are planning a Google Ads campaign for.
Query parameters
Currency to report the bounds in, as an ISO 4217 code. An unrecognized code falls back to USD.
Currency to report the bounds in, as an ISO 4217 code. An unrecognized code falls back to USD.
Campaign type to report bounds for: SMART or PERFORMANCE_MAX. Anything else falls back to SMART.
Campaign type to report bounds for: SMART or PERFORMANCE_MAX. Anything else falls back to SMART.
Response
The accepted daily budget range.
Example response
{
"currency_code": "USD",
"campaign_type": "SMART",
"min_daily_budget_micros": 10000000,
"max_daily_budget_micros": 1000000000,
"recommended_daily_budget_micros": 30000000,
"preset_daily_budget_micros": [
15000000,
30000000,
60000000
],
"usd_to_currency_rate": 1
}Changes
No recorded changes to this endpoint across all 1 revision of this API.