Google Ads v2

Provides integration with Google Ads, Google's online advertising platform. Advertisers and agencies use Google Ads to run search, display, video, shopping and app campaigns, manage budgets and bids, track conversions, and report on performance across one or many customer accounts.

The Node connects to the Google Ads API (version v26). It can run GAQL reports, read account resources, create, update and remove resources such as campaigns, ad groups and labels, and run provider actions such as keyword planning and offline conversion uploads. Use it to bring Google Ads reporting into other systems, or to keep campaigns and conversions in sync with your own data.

Revision History

0.0.0.1 - Initial release.

Connection

The Connection stores the Google Cloud OAuth client and the tokens obtained when you click Connect your Account. All Methods use it. You can also set the manager account and the default customer account that requests act on.

Setup Notes

Run this Node on a Cloud Runtime.

1. In Google Cloud, create or choose a project, enable the Google Ads API, and create an OAuth client. Add the Flowgear OAuth callback URL, https://app.flowgear.net/r/auth, to the client's authorized redirect URIs.
2. Make sure the project's Google Ads API access level allows the accounts you need. The access level (Test, Explorer, Basic or Standard) decides which accounts the Connection can reach. Google retired developer tokens on 9 September 2026, so the Connection has no developer token Property.
3. Enter ClientId and ClientSecret, then click Connect your Account and sign in with a Google user that has access to the Google Ads accounts. The Node requests offline access to the https://www.googleapis.com/auth/adwords scope.
4. If you reach client accounts through a manager account, enter its 10-digit ID in ManagerAccountId. Enter DefaultCustomerId to avoid repeating the customer ID in every Method.
5. Enter customer IDs as 10 digits without hyphens. The Node rejects 123-456-7890 instead of rewriting it.

You can supply an AccessToken on its own, but it can't be renewed. When it expires, the Node asks you to supply a new token.

Connections from the v1 Google Ads Node do not migrate. Create a new Connection and click Connect your Account. The v1 Node-level CustomerId becomes DefaultCustomerId or Options.customerId.

Methods

The Node groups the Google Ads API into six Methods by intent. In each Method, you choose a template that selects the operation and fills OperationId, Options and, where needed, Items. Options and Items use Google's own field names, such as customerId, query and resourceName. Options.customerId falls back to DefaultCustomerId when it is empty.

The Node handles paging itself. Templates have no page token, page size or search settings fields. The first page of a query, or the first batch or item of a mutation, is sent while the Node runs. Later pages and batches are sent as the next Node reads the results.

Query

Runs a GAQL report or another paged search with automatic pagination. The operations are googleAds:search (GAQL), googleAdsFields:search and generateKeywordIdeas.

The search template's default query is SELECT customer.id, customer.descriptive_name FROM customer, so it runs with only DefaultCustomerId set. The query sample shows a filtered campaign report you can adapt.

A query that matches nothing returns no rows. If Google rejects the first page, for example because of a GAQL syntax error, the Node raises that error instead of returning an empty result.

Read

Reads accounts, invoices, operations, batch job results and other fixed resources through Google's 11 GET operations, such as listAccessibleCustomers.

Create

Creates Google Ads resources, such as campaigns, ad groups and labels, through every resource mutate service that supports create.

The Flowgear object contains:

• IsSuccess: whether Google applied the item.
• Message: Created, or Validated when validateOnly is true, or the reason the item failed.
• Request: the original input item.

Update

Updates Google Ads resources through every resource mutate service that supports update.

updateMask is required on each item. The Node never derives it, because the mask decides which fields Google changes or clears. An item without an updateMask returns a failed row and is not sent.

Delete

Removes Google Ads resources by resource name through every resource mutate service that supports remove.

Delete templates leave resourceName empty, so a template can't remove anything as selected. An item without a resourceName returns a failed row and is not sent.

Action

Runs a Google Ads provider action, such as keyword planning, conversion uploads, recommendations, experiments, batch jobs and the mixed googleAds:mutate.

Actions such as uploadClickConversions require partialFailure: true in the item, so Google accepts the request even when some operations are rejected. Those rows report IsSuccess as false with the rejected operations' errors, and keep the results of the accepted operations.

Usage Notes

• Create, Update and Delete send items in batches of up to 1,000 operations. Where the service supports partial failure, each item succeeds or fails on its own. Where it doesn't, one bad item rejects the whole batch: that item is marked Rejected: with Google's errors, and the other items in the batch are marked Not applied:.
• If Google rejects the first batch or item as a whole, the Node fails and nothing more is sent. This happens for authentication, permission and quota errors, for example. On a later batch or item, a rejection marks only that batch or item as failed, and the Node continues with the rest.
• An expired access token is refreshed and the request is retried, up to two times. If Google reports the grant as revoked (invalid_grant), the Node asks you to reconnect the Connection. Permission errors such as USER_PERMISSION_DENIED and CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION are not refreshed and include a hint about what to check.
• Rate limits with a short retry delay (60 seconds or less) are retried automatically. Daily quota exhaustion fails immediately.
• String and integer lists are CSV text in both directions. Values that contain commas, quotes or line breaks are quoted with doubled quotes, and empty text is an empty list. Free-form provider fields are JSON text.
• When a request or response has a single object field, the template exposes that object's fields directly. For example, productLinks:create items are the productLink fields.
• Set validateOnly to true to have Google check items without changing anything.
• Template keys include the API version. When the Node moves to a newer Google Ads API version, reselect the templates in your Workflows.

Known Issues

• The Node has been validated against a Google Ads test account only, not a production account.
• googleAds:searchStream, media uploads and the long-running operation list, wait, cancel and delete calls are not available. Use googleAds:search in the Query Method instead of searchStream.
• The googleAds:search template describes the full GoogleAdsRow, so it is large and can take a moment to load in the Workflow designer.

See also

• Google Ads API REST reference
• Google Ads API version sunset dates
• Create a Connection
• Handle Partial Batch Failures