tools/integrations/google-ads.md
Pay-per-click advertising platform for search, display, and video campaigns.
| Integration | Available | Notes |
|---|---|---|
| API | ✓ | Google Ads API for campaign management |
| MCP | ✓ | Available via Google Ads MCP server |
| CLI | - | Use gcloud or API scripts |
| SDK | ✓ | Client libraries for multiple languages |
https://www.googleapis.com/auth/adwordsdeveloper-token, login-customer-id (for MCC)POST https://googleads.googleapis.com/v14/customers/{customer_id}/googleAds:searchStream
{
"query": "SELECT customer.id, customer.descriptive_name FROM customer"
}
POST https://googleads.googleapis.com/v14/customers/{customer_id}/googleAds:searchStream
{
"query": "SELECT campaign.id, campaign.name, campaign.status, campaign_budget.amount_micros FROM campaign ORDER BY campaign.id"
}
POST https://googleads.googleapis.com/v14/customers/{customer_id}/googleAds:searchStream
{
"query": "SELECT campaign.name, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_30_DAYS"
}
POST https://googleads.googleapis.com/v14/customers/{customer_id}/googleAds:searchStream
{
"query": "SELECT ad_group.name, metrics.impressions, metrics.clicks, metrics.conversions FROM ad_group WHERE segments.date DURING LAST_7_DAYS"
}
POST https://googleads.googleapis.com/v14/customers/{customer_id}/googleAds:searchStream
{
"query": "SELECT ad_group_criterion.keyword.text, metrics.impressions, metrics.clicks, metrics.average_cpc FROM keyword_view WHERE segments.date DURING LAST_30_DAYS ORDER BY metrics.clicks DESC LIMIT 50"
}
POST https://googleads.googleapis.com/v14/customers/{customer_id}/campaigns:mutate
{
"operations": [{
"update": {
"resourceName": "customers/{customer_id}/campaigns/{campaign_id}",
"status": "PAUSED"
},
"updateMask": "status"
}]
}
POST https://googleads.googleapis.com/v14/customers/{customer_id}/campaignBudgets:mutate
{
"operations": [{
"update": {
"resourceName": "customers/{customer_id}/campaignBudgets/{budget_id}",
"amountMicros": "50000000"
},
"updateMask": "amountMicros"
}]
}
| Metric | Description |
|---|---|
metrics.impressions | Ad impressions |
metrics.clicks | Clicks |
metrics.cost_micros | Cost in micros (divide by 1M) |
metrics.conversions | Conversions |
metrics.conversions_value | Conversion value |
metrics.average_cpc | Average cost per click |
metrics.ctr | Click-through rate |
metrics.conversion_rate | Conversion rate |
SEARCH - Search network text adsDISPLAY - Display networkSHOPPING - Product shopping adsVIDEO - YouTube video adsPERFORMANCE_MAX - AI-optimized across channelsDEMAND_GEN - Discovery/Demand GenSELECT
campaign.name,
metrics.clicks,
metrics.conversions
FROM campaign
WHERE
campaign.status = 'ENABLED'
AND segments.date DURING LAST_30_DAYS
ORDER BY metrics.conversions DESC
LIMIT 10