Google Ads

Report on Google Ads with validated GAQL; read campaigns, budgets, ad groups, ads, keywords and conversion actions; manage paused campaigns, budgets and statuses; upload offline click conversions.

Feed ad performance into BI, close the loop with CRM-qualified offline conversions and keep campaign status and budgets under controlled automation.

Build a flow with Google Ads Provider API documentation

Source actions

Destination actions

Data types

Validation status

Implemented · fixture tested.

Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.

What you can map

accessible customers

List accessible customers
Source
Customer accounts directly accessible to the authorised user.
accessible_customers.list

ad groups

Create paused ad group
Destination
Not retried automatically
Approval before production
Creates an ad group in PAUSED status.
ad_groups.create
List ad groups
Source
Ad groups with status, type, campaign and CPC bid.
ad_groups.list
Change ad group status or bid
Destination
Provider duplicate protection
Approval before production
Pauses or enables an ad group, or sets an explicit max CPC bid.
ad_groups.update

ads

Create paused responsive search ad
Destination
Not retried automatically
Approval before production
Creates a responsive search ad in PAUSED status.
ads.create
List ads
Source
Ads with type, status, approval status and final URLs.
ads.list
Change ad status
Destination
Provider duplicate protection
Approval before production
Pauses or enables an ad in an ad group.
ads.update

campaign budgets

Create campaign budget
Destination
Not retried automatically
Approval before production
Creates a non-shared daily budget for a new campaign.
campaign_budgets.create
List campaign budgets
Source
Budgets with amount, period and delivery method.
campaign_budgets.list
Change campaign budget
Destination
Provider duplicate protection
Approval before production
Sets a budget's daily amount to an explicit value.
campaign_budgets.update

campaigns

Create paused campaign
Destination
Not retried automatically
Approval before production
Creates a Search or Display campaign in PAUSED status with an existing budget; it does not serve until enabled.
campaigns.create
List campaigns
Source
Campaigns with status, channel, bidding strategy and budget.
campaigns.list
Change campaign status or name
Destination
Provider duplicate protection
Approval before production
Pauses, enables or renames a campaign. Enabling must be an explicit input.
campaigns.update

click conversions

Upload offline click conversion
Destination
Provider duplicate protection
Approval before production
Uploads one offline conversion for a click (gclid, gbraid or wbraid) with partial failure reporting.
click_conversions.create

conversion actions

List conversion actions
Source
Conversion actions (use the resource name when uploading click conversions).
conversion_actions.list

customers

Get customer
Source
The configured customer's name, currency, time zone and account type.
customers.get

keywords

List keywords
Source
Keyword criteria with match type, status and bids.
keywords.list

reports

Run performance report
Source
Runs a GAQL report built from an allow-listed resource, validated fields and a bounded date range.
reports.search

Authentication

Google OAuth client, refresh token and developer token

Plans and access

Requires a Google Ads manager account developer token (Basic or Standard access for production accounts). Test-access developer tokens only work with test accounts; the OAuth user needs access to the customer (directly or through the login manager account).

Test environment

Create a test manager account and test client accounts for test-access developer tokens.

Rate limits

Daily operation limits depend on developer token access level (Basic: 15,000 operations per day); RESOURCE_EXHAUSTED errors return HTTP 429.

Pagination

Named list operations use keyset pages ordered by resource ID; report queries return a single page of up to 1,000 rows (GAQL LIMIT).

Provider events

Google Ads has no webhooks. Nexra event triggers are not yet available; flows run on demand or on a schedule.

Before you build a flow

Pinned to Google Ads API v25; upgrade before its sunset (August 2027).
Campaigns, ad groups and ads are always created PAUSED; enabling them or changing budgets requires an explicit status or amount input.
Removing campaigns, ad groups, ads and budgets is not implemented.
Report queries are built only from an allow-listed resource, validated field names, a date preset or explicit dates and an optional campaign filter; free-form GAQL is not accepted.
Mutates other than click conversion uploads have no idempotency key; uncertain writes are not repeated automatically.
Click conversion uploads use partial failure; per-row errors are returned on the record instead of failing the run.

Developer reference

Create the Google credentials described above with the narrowest permissions your flows need.
In Nexra, open Connect, then Connections, then New connection, choose Google Ads, enter its settings and credentials, and tick only the write actions you need. Connection guide
Test the connection, then use its actions as flow sources and destinations. Flow guide

Google docsAPI reference Google docsAuthentication Google docsRate limits

Machine-readable detail: GET /api/public/connect/connectors/google-ads and the Connections API.