Tools
Google Ads
Query campaigns, ad groups, and performance metrics
Connect to Google Ads to list accessible accounts, list campaigns, view ad group details, get performance metrics, and run custom GAQL queries.
List all Google Ads customer accounts accessible by the authenticated user
| Parameter | Type | Required | Description |
|---|
developerToken | string | Yes | Google Ads API developer token |
| Parameter | Type | Description |
|---|
customerIds | array | List of accessible customer IDs |
totalCount | number | Total number of accessible customer accounts |
Run a custom Google Ads Query Language (GAQL) query
| Parameter | Type | Required | Description |
|---|
customerId | string | Yes | Google Ads customer ID (numeric, no dashes) |
developerToken | string | Yes | Google Ads API developer token |
managerCustomerId | string | No | Manager account customer ID (if accessing via manager account) |
query | string | Yes | GAQL query to execute |
pageToken | string | No | Page token for pagination |
| Parameter | Type | Description |
|---|
results | json | Array of result objects from the GAQL query |
totalResultsCount | number | Total number of matching results |
nextPageToken | string | Token for the next page of results |
List campaigns in a Google Ads account with optional status filtering
| Parameter | Type | Required | Description |
|---|
customerId | string | Yes | Google Ads customer ID (numeric, no dashes) |
developerToken | string | Yes | Google Ads API developer token |
managerCustomerId | string | No | Manager account customer ID (if accessing via manager account) |
status | string | No | Filter by campaign status (ENABLED, PAUSED, REMOVED) |
limit | number | No | Maximum number of campaigns to return |
| Parameter | Type | Description |
|---|
campaigns | array | List of campaigns in the account |
totalCount | number | Total number of campaigns returned |
Get performance metrics for Google Ads campaigns over a date range
| Parameter | Type | Required | Description |
|---|
customerId | string | Yes | Google Ads customer ID (numeric, no dashes) |
developerToken | string | Yes | Google Ads API developer token |
managerCustomerId | string | No | Manager account customer ID (if accessing via manager account) |
campaignId | string | No | Filter by specific campaign ID |
dateRange | string | No | Predefined date range (LAST_7_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH, TODAY, YESTERDAY) |
startDate | string | No | Custom start date in YYYY-MM-DD format |
endDate | string | No | Custom end date in YYYY-MM-DD format |
| Parameter | Type | Description |
|---|
campaigns | array | Campaign performance data broken down by date |
totalCount | number | Total number of result rows |
List ad groups in a Google Ads campaign
| Parameter | Type | Required | Description |
|---|
customerId | string | Yes | Google Ads customer ID (numeric, no dashes) |
developerToken | string | Yes | Google Ads API developer token |
managerCustomerId | string | No | Manager account customer ID (if accessing via manager account) |
campaignId | string | Yes | Campaign ID to list ad groups for |
status | string | No | Filter by ad group status (ENABLED, PAUSED, REMOVED) |
limit | number | No | Maximum number of ad groups to return |
| Parameter | Type | Description |
|---|
adGroups | array | List of ad groups in the campaign |
totalCount | number | Total number of ad groups returned |
Get performance metrics for individual ads over a date range
| Parameter | Type | Required | Description |
|---|
customerId | string | Yes | Google Ads customer ID (numeric, no dashes) |
developerToken | string | Yes | Google Ads API developer token |
managerCustomerId | string | No | Manager account customer ID (if accessing via manager account) |
campaignId | string | No | Filter by campaign ID |
adGroupId | string | No | Filter by ad group ID |
dateRange | string | No | Predefined date range (LAST_7_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH, TODAY, YESTERDAY) |
startDate | string | No | Custom start date in YYYY-MM-DD format |
endDate | string | No | Custom end date in YYYY-MM-DD format |
limit | number | No | Maximum number of results to return |
| Parameter | Type | Description |
|---|
ads | array | Ad performance data broken down by date |
totalCount | number | Total number of result rows |
- Category:
tools
- Type:
google_ads
