Creates a new Google Ads campaign with a budget.
This call changes nothing in Google Ads on its own: it returns a preview
of the change and a one-time confirm_token. The change is made only by
confirm_changes with that token, within 10 minutes.
The campaign is always created paused: it shows no ads and spends
nothing until it is switched on in a separate step.
SEARCH campaigns are created with Google search on, Search partners off,
the Display Network off, and location targeting set to PRESENCE (people
in the targeted locations). Pass search_partners, display_network or
geo_target_type to choose other values. On a campaign of any other
channel type, each of these three settings is set only when its argument
is passed.
Search campaigns have no language setting: Google Ads removed it in late
September 2026 and matches Search ads to searchers by the language the
ads are written in, so write the ads in the language customers search
in. Searches in another language that cost money are stopped with
add_negative_keywords. languages sets a DISPLAY campaign's language
setting in the same request as the campaign; without it the campaign has
no language setting, may show to people who use any language, and the
result says so. languages is refused on SEARCH.
SHOPPING is turned off until Shopping campaign creation is complete: a
Shopping campaign needs a Merchant Center account, a feed label and a
product group, which this tool does not set yet, so it is refused before
anything is sent. VIDEO is refused before anything is sent: the Google
Ads API cannot create or change Video campaigns. MULTI_CHANNEL (App) is
refused before anything is sent: an App campaign needs an app ID, an app
store and a bidding goal, which this tool does not set.
The budget and the campaign are created together in one request, so if
Google refuses the campaign no budget is left behind. The budget belongs
to this campaign alone (it is not a shared budget). A channel type or
bidding strategy outside the lists below, a strategy the channel type
does not take, or a target missing or given to the wrong strategy, is
refused before anything is sent.
Bidding strategies by channel type:
SEARCH: MANUAL_CPC, TARGET_SPEND, MAXIMIZE_CONVERSIONS, TARGET_CPA,
MAXIMIZE_CONVERSION_VALUE, TARGET_ROAS.
DISPLAY: MANUAL_CPC, TARGET_SPEND, MAXIMIZE_CONVERSIONS, TARGET_CPA,
TARGET_ROAS. Google does not offer MAXIMIZE_CONVERSION_VALUE
without a target ROAS on Display campaigns.
Args:
customer_id: The Google Ads customer ID (numbers only, no hyphens).
name: The name for the new campaign.
budget_amount_micros: Daily budget in micros of the account's currency (10000000 = 10.00: ₹10 on an INR account, $10 on a USD one).
advertising_channel_type: Channel type. One of: SEARCH, DISPLAY. Default: SEARCH. SHOPPING is turned off until Shopping campaign creation is complete; VIDEO is refused (the Google Ads API cannot create Video campaigns); MULTI_CHANNEL (App) is refused (it needs an app ID, an app store and a bidding goal this tool does not set). For Performance Max use create_performance_max_campaign.
status: Initial campaign status: PAUSED, the only status a build takes. Every campaign is built paused and is switched on in a separate step; ENABLED is refused, and nothing in that call runs. Default: PAUSED.
bidding_strategy_type: Bidding strategy. One of: MANUAL_CPC, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_CPA, TARGET_ROAS, TARGET_SPEND, as the channel type takes it (list above). Default: MANUAL_CPC.
target_cpa_micros: Target CPA in micros of the account's currency. Required with TARGET_CPA, refused with any other strategy.
target_roas: Target ROAS (e.g., 2.0 for 200%). Required with TARGET_ROAS, refused with any other strategy.
cpc_bid_ceiling_micros: Maximize Clicks' max CPC cap — the most
Google may bid for one click — in micros of the account's currency
(10000000 = 10.00: ₹10 on an INR account, $10 on a USD one). Only
with bidding_strategy_type TARGET_SPEND. Optional.
start_date: Campaign start date in YYYY-MM-DD format. Optional.
end_date: Campaign end date in YYYY-MM-DD format. Optional.
search_partners: Whether ads may serve on the Google Search Partners
network. SEARCH default: False. Optional.
display_network: Whether ads may serve on the Google Display Network.
SEARCH default: False. Optional.
geo_target_type: Positive location targeting. One of: PRESENCE (only
people in the targeted locations), PRESENCE_OR_INTEREST (also
people elsewhere who show interest in them), SEARCH_INTEREST.
SEARCH default: PRESENCE. Optional.
languages: Google Ads language codes (e.g. en, hi, es, pt, de, fr,
ja, zh_CN) a DISPLAY campaign may show to. ["all"] sets no
language setting on purpose. Refused on SEARCH. Optional.
over_comfort_ack: The user's own words or reason when they asked for
a budget above their saved comfort (e.g. "user asked for 6,000/day
on 2026-09-23"). Recorded with the change by the hosted connector;
never sent to Google. Optional.
Returns:
Dictionary with created campaign and budget resource names; on a
DISPLAY campaign also the language codes set (an empty list means
every language).
Tools revision: 8ebdf5be.
