Google Ads
Integrate your application with the Google Ads API
🚀 Quickstart
Connect to Google Ads with Tenklo and see data flow in 2 minutes.
In Tenklo (free signup), go to Integrations -> Configure New Integration -> Google Ads. Tenklo doesn't provide a test OAuth app for Google Ads yet. You'll need to set up your own by following the setup guide linked below. After that, make sure to add the OAuth client ID, secret, and scopes in the integration settings in Tenklo.
Go to Connections -> Add Test Connection -> Authorize, then log in to Google. Later, you'll let your users do the same directly from your app.
Let's make your first request to the Google Ads API. Replace the placeholders below with your Environment API key, integration ID, and connection ID:
curl "https://api.tenklo.dev/proxy/googleads/v17/customers" \
-H "Authorization: Bearer <NANGO-API-KEY>" \
-H "Provider-Config-Key: <INTEGRATION-ID>" \
-H "Connection-Id: <CONNECTION-ID>"Or fetch credentials with the Node SDK or API.
✅ You're connected! Check the Logs tab in Tenklo to inspect requests.
Follow our Auth implementation guide to integrate Tenklo in your app.
To obtain your own production credentials, follow the setup guide linked below.
📚 Google Ads Integration Guides
Tenklo maintained guides for common use cases.
-
How to register your own Google Ads OAuth app
Register an OAuth app with Google for Google Ads and obtain credentials to connect it to Tenklo -
Google App & Security Review Pass Google's OAuth app verification to go to production
Official docs: Google Ads API Documentation
🧩 Pre-built syncs & actions for Google Ads
Explore Nango-provided actions in your dashboard. Extend and customize them to fit your needs.
Others
| Function name | Description | Type | Source code |
|---|---|---|---|
create-ad-group-ad | Create an ad inside an ad group. | Action | 🔗 Github |
create-ad-group | Create an ad group in an existing Google Ads campaign | Action | 🔗 Github |
create-campaign-budget | Create a campaign budget for one or more campaigns. | Action | 🔗 Github |
create-campaign-location-criterion | Add geographic location targeting to a campaign using a geo target constant. | Action | 🔗 Github |
create-campaign-negative-keyword | Add a negative keyword criterion at the campaign level. | Action | 🔗 Github |
create-campaign | Create a campaign that references an existing budget. | Action | 🔗 Github |
create-conversion-action | Create a conversion action for tracking conversions. | Action | 🔗 Github |
create-keyword-criterion | Add a positive keyword criterion to an ad group. | Action | 🔗 Github |
create-negative-keyword | Add a negative keyword criterion to an ad group so its ads stop showing for that term. | Action | 🔗 Github |
generate-keyword-ideas | Generate keyword ideas and search volume/competition metrics from a seed keyword list or URL. | Action | 🔗 Github |
list-accessible-customers | List customer accounts directly accessible to the authenticated user. | Action | 🔗 Github |
remove-ad-group-ad | Remove an ad from an ad group by resource name. | Action | 🔗 Github |
remove-ad-group | Remove an ad group by resource name. | Action | 🔗 Github |
remove-campaign-budget | Remove an unused campaign budget by resource name. | Action | 🔗 Github |
remove-campaign-criterion | Remove a campaign-level criterion (negative keyword or location target) by resource name. | Action | 🔗 Github |
remove-campaign | Remove a campaign by resource name. | Action | 🔗 Github |
remove-conversion-action | Remove a conversion action by resource name. | Action | 🔗 Github |
remove-keyword-criterion | Remove a keyword criterion from an ad group. | Action | 🔗 Github |
search-google-ads | Run a GAQL query and return paged Google Ads rows. | Action | 🔗 Github |
search-stream-google-ads | Run a GAQL query with streamed results | Action | 🔗 Github |
suggest-geo-target-constants | Look up geo target constant resource names for location names or codes, for use in campaign location targeting. | Action | 🔗 Github |
update-ad-group-ad | Update mutable fields on an ad group ad | Action | 🔗 Github |
update-ad-group | Update mutable fields on an ad group. | Action | 🔗 Github |
update-campaign-budget | Update mutable fields on a campaign budget. | Action | 🔗 Github |
update-campaign | Update mutable campaign settings. | Action | 🔗 Github |
update-conversion-action | Update mutable fields on a conversion action | Action | 🔗 Github |
update-keyword-criterion | Update mutable fields on an ad group keyword criterion. | Action | 🔗 Github |
validate-google-ads-mutate | Validate a mutate request without applying changes. | Action | 🔗 Github |
accessible-customers | Sync directly accessible Google Ads customer accounts | Sync | 🔗 Github |
ad-group-ads | Sync ad group ads for customer accounts in scope. | Sync | 🔗 Github |
ad-groups | Sync ad groups for customer accounts in scope. | Sync | 🔗 Github |
campaign-budgets | Sync campaign budgets for customer accounts in scope | Sync | 🔗 Github |
campaign-criteria | Sync campaign-level criteria (negative keywords and location targeting) for customer accounts in scope. | Sync | 🔗 Github |
campaigns | Sync campaigns for customer accounts in scope. | Sync | 🔗 Github |
conversion-actions | Sync conversion actions configured on customer accounts in scope | Sync | 🔗 Github |
keyword-criteria | Sync ad group keyword criteria for customer accounts in scope | Sync | 🔗 Github |