Google Ads
Create Search and Display campaigns, mine keywords, and query GAQL with Zernio API
Quick Reference
| Property | Value |
|---|---|
| Hierarchy | Campaign → Ad Group → Ad (created in one call) |
| Campaign types (create) | Search (Responsive Search Ads), Display (Responsive Display Ads) |
| Goals (`goal`) | engagement, traffic, awareness, video_views (conversion goals not yet on create) |
| Keyword targeting | Broad, Phrase, Exact; synced keyword list + Keyword Planner |
| Reporting | Rolled-up metrics on /ads/tree plus raw GAQL passthrough (see Insights & GAQL) |
| Discovered campaigns | All types sync into /ads/tree with metrics, including Performance Max |
| Audiences | Customer Match (create + member upload) |
| Conversions | Data Manager API (click IDs + Enhanced Conversions for Leads), EEA/UK consent |
| URL tracking tags | Campaign-level trackingUrlTemplate + finalUrlSuffix (read + update) |
| Search ad text | 15 headlines (30 chars) / 4 descriptions (90 chars) |
| Display images | Landscape 1.91:1 AND square 1:1 both required, JPEG/PNG, 5120 KB |
Before You Start
Google Ads uses a dedicated OAuth connection (separate from YouTube or Google Business Profile).
Requirements:
- A Google Ads account (the customer ID, from
GET /v1/ads/accounts); accounts under an MCC manager are supported - No MCC or Standard Access application on your side: Zernio operates under its own approved developer token
- Display campaigns need two images: Google's Responsive Display Ads require BOTH a landscape (1.91:1) and a square (1:1) marketing image; sending only one is rejected upstream (
NOT_ENOUGH_SQUARE_MARKETING_IMAGE_ASSET) - Google's API quota is shared across Zernio: user-driven reads (GAQL, Keyword Planner, tag audits) are metered per user, see Media & Limits
OAuth Scopes
| Scope | What it enables |
|---|---|
https://www.googleapis.com/auth/adwords | Full Google Ads API access: campaigns, ad groups, ads, reporting, conversions |
https://www.googleapis.com/auth/datamanager | Data Manager API: Customer Match audience uploads |
In This Section
Create Ads
Search and Display campaigns in one call
Keywords
Synced keyword criteria and the Keyword Planner
Customer Match
CRM-list audiences with hashed member upload
Insights & GAQL
Rolled-up metrics and raw GAQL queries
Conversions
Offline and enhanced conversions via Data Manager
URL Tracking Tags
Campaign tracking templates and final URL suffixes
Media & Limits
Media requirements, quotas, and what you can't do
Related Endpoints
- Create Standalone Ad - Campaign, ad group, and ad in one call
- List Ad Keywords - Synced Search keyword criteria
- Keyword Ideas and Historical Metrics
- Query Ad Insights - Raw GAQL passthrough
- Ad Audiences - Customer Match
- Send Conversions - Data Manager events