Skip to main content
POST
Suggest Google Ads budget options

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.

Body

application/json
keyword_themes
string[]

Themes the campaign would match on, up to 25.

Maximum array length: 25
Example:
landing_page
string | null

Page the campaign would send clicks to, as an http or https URL. Required: a request without one is rejected with a 400.

Example:

"https://example.com/furniture"

geo_targets
string[]

Locations to plan for, up to 50, as Google geo target constant IDs (geoTargetConstants/1023191, or just 1023191). Entries in any other form are dropped, and at least one usable entry is required.

Maximum array length: 50
Example:
language_code
string
default:""

Two-letter code of the language the ads would run in. A missing or unsupported code plans in English.

Example:

"en"

business_name
string
default:""

Business name, which sharpens Google's forecast. Only the first 120 characters are used.

Example:

"Oakline Furniture"

Response

Google's budget options, as Google sent them.

Google's low, recommended and high daily budgets for a Smart campaign.

low
GoogleAdsBudgetOption · object | null

The lowest budget Google suggests. Absent or null when Google has no tier at this level.

The budget Google recommends. Absent or null when Google has none.

high
GoogleAdsBudgetOption · object | null

The highest budget Google suggests. Absent or null when Google has no tier at this level.