Overview
Google Ads is the dominant search + display + YouTube ad platform. The Automize Google Ads connector covers campaigns, ad groups, ads, keywords, reports, budgets.
- Regions: Global.
- Plans: Pay-per-click. API free.
Setting up the connection
Auth type: OAuth 2.0 (Authorization Code).
- Apply for Google Ads API access (Developer Token).
- OAuth client via Google Cloud Console.
- In Automize → Settings → Connectors → Google Ads. Paste credentials + developer token + customer ID.
Find your credentials at https://ads.google.com/aw/apicenter.
Rate limits
Tier-based – Basic 15k operations/day, Standard much higher.
Data model
Ads hierarchy:
MCC (Manager) ─── Customers (advertiser accounts)
├─ Campaigns ─── Ad Groups ─── Ads + Keywords
├─ Budgets
└─ Reports (GAQL)Available operations
8 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Get Customer | General | Get customer account details |
| List Accessible Customers | General | List customer accounts the user has access to |
| Mutate Ad Groups | General | Create, update, or remove ad groups |
| Mutate Ads | General | Create, update, or remove ad group ads |
| Mutate Budgets | General | Create, update, or remove campaign budgets |
| Mutate Campaigns | General | Create, update, or remove campaigns |
| Search | General | Run a GAQL query against a customer account |
| Search Stream | General | Stream GAQL query results for a customer |
Operations
Get Customer
Get customer account details
| Parameter | Required | Type | Description |
|---|---|---|---|
Customer Id customer_id | Yes | text |
List Accessible Customers
List customer accounts the user has access to
No input parameters.
Mutate Ad Groups
Create, update, or remove ad groups
| Parameter | Required | Type | Description |
|---|---|---|---|
Operations operations | Yes | text | |
Customer Id customer_id | Yes | text |
Mutate Ads
Create, update, or remove ad group ads
| Parameter | Required | Type | Description |
|---|---|---|---|
Operations operations | Yes | text | |
Customer Id customer_id | Yes | text |
Mutate Budgets
Create, update, or remove campaign budgets
| Parameter | Required | Type | Description |
|---|---|---|---|
Operations operations | Yes | text | |
Customer Id customer_id | Yes | text |
Mutate Campaigns
Create, update, or remove campaigns
| Parameter | Required | Type | Description |
|---|---|---|---|
Operations operations | Yes | text | |
Customer Id customer_id | Yes | text |
Search
Run a GAQL query against a customer account
| Parameter | Required | Type | Description |
|---|---|---|---|
Query query | Yes | text | |
Pagesize pageSize | Yes | text | |
Customer Id customer_id | Yes | text |
Search Stream
Stream GAQL query results for a customer
| Parameter | Required | Type | Description |
|---|---|---|---|
Query query | Yes | text | |
Customer Id customer_id | Yes | text |
FAQ
- GAQL?
- Google Ads Query Language – SQL-like, used for all reads. Very flexible. Learning curve.