Skip to main content
GET
Get Google Ads budget boundaries

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

app_id
string
required

ID of the app you are planning a Google Ads campaign for.

Query Parameters

currency_code
string
default:USD

Currency to report the bounds in, as an ISO 4217 code. An unrecognized code falls back to USD.

campaign_type
string
default:SMART

Campaign type to report bounds for: SMART or PERFORMANCE_MAX. Anything else falls back to SMART.

campaign_id
string | null

An existing campaign to quote the click rate for. With it, clicks_per_unit_min / clicks_per_unit_max describe that campaign's own recent delivery instead of the platform-wide range, and clicks_per_unit_scope reads campaign. A campaign without enough delivery, or one whose budget currency differs from currency_code, still answers from the platform-wide range.

Response

The accepted daily budget range.

The daily budget range Google accepts for a campaign type and currency.

currency_code
string
required

The currency these amounts are in, upper-cased from what you sent.

Example:

"USD"

campaign_type
string
required

The campaign type these bounds apply to, upper-cased from what you sent.

Example:

"SMART"

min_daily_budget_micros
integer
required

Smallest daily budget Google accepts for this campaign type and currency, in micros (1,000,000 micros = 1 unit of the currency). Sending less than this to Create campaign is rejected with a 400.

Example:

10000000

max_daily_budget_micros
integer
required

Largest daily budget accepted for this campaign type and currency, in micros.

Example:

1000000000

A sensible starting daily budget, in micros. Never above max_daily_budget_micros.

Example:

30000000

preset_daily_budget_micros
integer[]
required

Three suggested daily budgets, in micros, from lowest to highest. These are raw presets, so unlike recommended_daily_budget_micros the highest one can sit above max_daily_budget_micros.

Example:
usd_to_currency_rate
number
required

How many units of this currency Base44 counts per US dollar when it converts the presets.

Example:

1

clicks_per_unit_min
number
required

Low end of the clicks one unit of currency_code in daily budget has actually bought. Multiply a daily budget by this directly — it is already in the same currency the budget is, so no conversion is involved. Always present — check clicks_per_unit_scope to see whether it is a live measurement.

Example:

1.9

clicks_per_unit_max
number
required

High end of the same range, with the same caveat: measured when clicks_per_unit_scope is campaign or fleet, a stored rate when it is unavailable.

Example:

21.2

clicks_per_unit_scope
string
required

Where the click range came from, and whether it is a measurement at all. campaign: measured on the campaign named by campaign_id. fleet: measured across accounts billing in this currency — also what an unknown campaign, or one without enough delivery, returns. unavailable: NOT measured — a stored range is being served because this currency has too few accounts to measure or the measurement could not be read. The range is usable in every case, but only the first two are measured.

Example:

"fleet"