Writes (money-moving)

gads_propose_create_campaign

Propose a brand-new Search campaign: a dedicated daily budget, the campaign shell, and its geo + language targeting, created atomically and always PAUSED.

Propose a brand-new Search campaign: a dedicated daily budget, the campaign shell, and its geo + language targeting, created atomically and always PAUSED. Always queues for operator approval (new spend authorization). After it is approved and applied, build the structure with proposeCreateAdGroup + proposeCreateRsa, then go live with proposeCampaignStatus. Resolve geo target constant ids with runGaqlQuery on geo_target_constant (e.g. SELECT geo_target_constant.id, geo_target_constant.canonical_name FROM geo_target_constant WHERE geo_target_constant.name LIKE 'France'). Launch MAXIMIZE_CONVERSIONS without a target first; introduce a target after ~30 conversions.

Scope: write token required · money-moving. Every write is dry-run validated, then classified by the safe-apply policy — auto-applied when bounded and low-risk, otherwise queued for approval.

Parameters

ParameterTypeRequiredDescription
namestringYes
dailyBudgetMicrosintegerYes
biddingStrategy"MAXIMIZE_CONVERSIONS" | "MAXIMIZE_CONVERSION_VALUE" | "MANUAL_CPC"No(default: "MAXIMIZE_CONVERSIONS")
targetCpaMicrosintegerNo
targetRoasnumberNo
geoTargetsobject[]Yes
languageConstantIdsstring[]No(default: ["1000"])
searchPartnersbooleanNo(default: false)
startDatestringNo
endDatestringNo
containsEuPoliticalAdvertisingbooleanNo(default: false)
reasonstringYes
projectIdstringNoTarget account (project id). Required with an org-scoped token for account-scoped tools — call gads_list_ad_accounts to enumerate accounts. Omit with a project-scoped token.

On this page