Home Nodes Google Ads

Google Ads

Provides integration with the Google Ads REST API, enabling you to perform operations such as retrieving campaigns, managing ad groups, running GAQL queries, and more within your Google Ads account.

Revision History

1.20.0.0 Initial Release - Supports Google Ads API V20
1.20.1.0 Property changes - Moved CustomerId to Node to allow single manager handling multiple customers easier

Properties

Connection

Type: Connection Input
The connection profile for your Google Ads account and authentication details.

ManagerAccountId
Type: String
(Optional) The Google Ads Manager Account ID (MCC). Required only when authenticating as a manager account to access client accounts. Must include dashes (e.g., 123-456-7890).

DeveloperToken
Type: Password
Your Google Ads Developer Token. Identifies your application and is required for API requests.

ClientId
Type: String
The Client ID from your Google Cloud OAuth credentials.

ClientSecret
Type: Password
The Client Secret from your Google Cloud OAuth credentials.

AccessToken
Type: Password Output
The OAuth 2.0 Access Token issued after successful authentication. Required for API calls.

RefreshToken
Type: Password Output
The OAuth 2.0 Refresh Token, used to obtain new Access Tokens without re-authentication.

CustomerId

Type: String Input
The Google Ads Customer ID for the account you want to target. Must be provided as a numeric string without dashes (e.g., 1234567890).

OperationId

Type: String Input
The internal ID of the selected Google Ads API operation. Set automatically when selecting a sample.

Description

Type: String Input
A short description of the selected operation. Set automatically when selecting a sample.

Request

Type: JSON Input
The JSON body for the API request. Used for operations like searches or mutations. Leave empty for GET requests.

Response

Type: JSON Output
The JSON response returned by the Google Ads API after the operation completes.

Setup

To use this node, follow these steps:

  1. Create a Google Cloud Project

    • Go to the Google Cloud Console.
    • Create a new project or select an existing one.
    • Enable the Google Ads API in your project’s API Library.

  2. Create OAuth 2.0 Credentials

    • In the Cloud Console, navigate to APIs & Services > Credentials.
    • Click Create Credentials > OAuth client ID.
    • Choose Web Application as the Application Type.
    • Enter a name for your OAuth client.
    • Under Authorized redirect URIs, add your platform’s OAuth redirect URI.
      • For details on your platform’s redirect URI, see OAuth Setup.
    • Save and note the Client ID and Client Secret.

  3. Obtain a Developer Token

    • Sign in to your Google Ads Manager Account.
    • Navigate to the API Center.
    • Apply for a Developer Token if you don’t already have one.
    • Developer Tokens issued for test accounts work only with Google Ads Test Accounts.

  4. Create or Use a Google Ads Test Account

    • Google Ads Test Accounts can be created via the Google Ads UI or the Google Ads API.
    • Use a test account Customer ID (numeric, no dashes) for development and testing.

  5. Configure the Node Connection

    • Enter the following connection properties in the node:
      • ManagerAccountId (optional): Only required if your credentials are for a manager account and you’re accessing a client account.
      • DeveloperToken: Your Developer Token.
      • ClientId and ClientSecret: OAuth credentials from step 2.

  6. Connect Your Account

  7. Set the Target Customer

    • In the node itself, set the CustomerId property to the Google Ads account you want to query or operate on.

Remarks

  • The node uses Google's recommended OAuth 2.0 flow for authentication.
  • The CustomerId is a required property at the node level and must be provided as a numeric string without dashes.
  • The ManagerAccountId is only needed when using a manager (MCC) account to access client accounts.
  • Only test accounts are supported unless your Developer Token is approved for production access.

See Also