Google Ads
API versie: Google Ads API v20+ · Officiële docs: https://developers.google.com/google-ads/api/docs/start
OAuth-flow
OAuth 2.0 met access_type=offline + prompt=consent voor refresh_token
| Authorization URL | https://accounts.google.com/o/oauth2/v2/auth |
| Token URL | https://oauth2.googleapis.com/token |
| Token body format | application/x-www-form-urlencoded |
| Scopes | https://www.googleapis.com/auth/adwords |
| API base URL | https://googleads.googleapis.com/v20 |
| Auth header | Authorization: Bearer + developer-token: <GOOGLE_ADS_DEVELOPER_TOKEN> + optioneel login-customer-id voor MCC |
Wat wordt gesynchroniseerd
- Accessible customers (incl. MCC)
- Campaigns
- Daily metrics via GAQL searchStream (impressions, clicks, cost_micros, conversions)
Sync interval: Elke uur
Rate limits
Google Ads heeft per-developer-token quota + per-customer ops/day; wij gebruiken searchStream voor efficiëntie
Bekende beperkingen
- Vereist een goedgekeurde Google Ads developer-token — vraag aan via Google Ads API Center (1-2 weken approval)
- Manager (MCC) accounts vereisen extra login-customer-id header per request
- Google Ads Customer ID heeft formaat 123-456-7890 — wij strippen automatisch streepjes
Verbinden
- Ga in je workspace naar
/connections - Klik op "Verbinden" bij Google Ads
- Log in bij Google Ads en geef toestemming voor de scopes
- Selecteer welk ad-account je wilt synchroniseren
- De eerste sync start automatisch; volgende syncs draaien elke uur