> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Google Ads budget boundaries
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
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.
This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/google-ads/campaigns/budget-boundaries
openapi: 3.1.0
info:
title: Base44 App Management API
version: 1.0.0
servers:
- url: https://app.base44.com
security:
- ApiKeyAuth: []
paths:
/api/apps/{app_id}/google-ads/campaigns/budget-boundaries:
get:
summary: Get Google Ads budget boundaries
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
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.
This endpoint accepts a personal API key. Workspace API keys are
not authorized for it and are rejected with a 403.
operationId: >-
get_campaign_budget_boundaries_api_apps__app_id__google_ads_campaigns_budget_boundaries_get
parameters:
- name: app_id
in: path
required: true
schema:
type: string
description: ID of the app you are planning a Google Ads campaign for.
title: App Id
description: ID of the app you are planning a Google Ads campaign for.
example: 6820f3a4e7b91d003c45a1f2
- name: currency_code
in: query
required: false
schema:
type: string
description: >-
Currency to report the bounds in, as an ISO 4217 code. An
unrecognized code falls back to `USD`.
default: USD
title: Currency Code
description: >-
Currency to report the bounds in, as an ISO 4217 code. An
unrecognized code falls back to `USD`.
example: USD
- name: campaign_type
in: query
required: false
schema:
type: string
description: >-
Campaign type to report bounds for: `SMART` or `PERFORMANCE_MAX`.
Anything else falls back to `SMART`.
default: SMART
title: Campaign Type
description: >-
Campaign type to report bounds for: `SMART` or `PERFORMANCE_MAX`.
Anything else falls back to `SMART`.
example: SMART
responses:
'200':
description: The accepted daily budget range.
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleAdsBudgetBoundaries'
'401':
description: Missing or invalid credentials.
'403':
description: >-
You don't have access to this app, the app does not exist, or you
used a workspace API key. A missing app and an app you cannot reach
are deliberately the same answer.
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
GoogleAdsBudgetBoundaries:
properties:
currency_code:
type: string
title: Currency Code
description: The currency these amounts are in, upper-cased from what you sent.
example: USD
campaign_type:
type: string
title: Campaign Type
description: >-
The campaign type these bounds apply to, upper-cased from what you
sent.
example: SMART
min_daily_budget_micros:
type: integer
title: Min Daily Budget Micros
description: >-
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](/api-reference/create-google-ads-campaign) is rejected
with a 400.
example: 10000000
max_daily_budget_micros:
type: integer
title: Max Daily Budget Micros
description: >-
Largest daily budget accepted for this campaign type and currency,
in micros.
example: 1000000000
recommended_daily_budget_micros:
type: integer
title: Recommended Daily Budget Micros
description: >-
A sensible starting daily budget, in micros. Never above
`max_daily_budget_micros`.
example: 30000000
preset_daily_budget_micros:
items:
type: integer
type: array
title: Preset Daily Budget Micros
description: >-
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:
- 15000000
- 30000000
- 60000000
usd_to_currency_rate:
type: number
title: Usd To Currency Rate
description: >-
How many units of this currency Base44 counts per US dollar when it
converts the presets.
example: 1
type: object
required:
- currency_code
- campaign_type
- min_daily_budget_micros
- max_daily_budget_micros
- recommended_daily_budget_micros
- preset_daily_budget_micros
- usd_to_currency_rate
title: GoogleAdsBudgetBoundaries
description: The daily budget range Google accepts for a campaign type and currency.
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: api_key
description: Personal API key.
````