Active with remarks
This application needs additional settings. Please follow the documentation below to create your own connection.
Redirect url
https://integrator.boost.space/oauth/cb/google-ads2

Google Ads Campaign Management

With Google Ads Campaign Management modules in Boost.space Integrator, you can watch for, search, retrieve, and/or update campaigns, groups, keywords, and objects, add placements to placement exclusion lists, add negative keywords to negative keyword lists, and retrieve accounts.

In order to use Google Ads Campaign Management with Boost.space Integrator, you must have a Google account. If you do not have one, you can create a Google account at accounts.google.com.

[Note] Note

Boost.space Integrator‘s use and transfer of information received from Google APIs to any other app will adhere to Google API Services User Data Policy.

[Important] Important

Some adblocking browser plugins could block the Google Ads Campaign Management modules. Boost.space Integrator recommends disabling the plugins if you encounter a problem loading a module.

Obtain client credentials for your custom app

To obtain the client credentials, you must have access to Google Cloud Console and be able to create or edit the project.

  1. Sign in to Google Cloud console using your Google credentials.

  2. In the upper-left corner, click Select a project > NEW PROJECT. Enter the desired project name, and click the CREATE button.

    61f26f540fc73.gif
  3. Select the project you have created.

    61f26f58533ba.gif
  4. Go to APIs & Services > Library.

    61f26f5b27f1a.gif
  5. Search and enable the following required APIs:

    • Cloud Resource Manager API

    • Google Drive API

    The desired service option should display as you type. Select the API/service you want to connect to Boost.space Integrator.

    61f26f5e01d32.gif
  6. Click the ENABLE button to enable the selected API.

  7. In the left sidebar, click  APIs & Services > OAuth consent screen.

    61f26f606a4df.gif
  8. Choose the External option, and click the CREATE button.

    [Note] Note

    You will not be charged when selecting this option! For more details, please refer to Google’s Exceptions to verification requirements.

  9. Fill in the required fields as follows, and then click Save and Continue:

    App name

    Enter the name of the app asking for consent. For example,  Boost.space Integrator.

    User support email

    Developer contact info

    Authorized domains

    • make.com

    • integromat.com

    • celonis.cloud

  10. On theScopespage, click Add or Remove Scopes. Under Manually Add Scopes, add the following scopes if they are not listed above.

    • https://mail.google.com

    • https://www.googleapis.com/auth/drive

  11. Click Add to Table then click Update.

  12. Click the X in the upper-left corner to close the Scopes box.

  13. Click Save and Continue.

  14. In the Test Users section, click ADD USERS and enter the testing user email address to access the app.

    google-cloud-storage-1.png
  15. Review the Summary page. Click Back to Dashboard.

  16. In the left sidebar, click Credentials. Click the +CREATE CREDENTIALS and select the OAuth Client ID option.

    61f26f63118aa.gif
  17. Fill in the required fields as follows, and then click the Create button to create the application:

    61f26f65799c3.gif

    Application type

    web application

    Name

    Name of the application. For example, Boost.space Integrator.

    Authorized redirect URIs

    https://integrator.boost.space/oauth/cb/google-restrictedhttps://www.celonis.cloud/oauth/cb/google-restricted

  18. A dialog containing the app’s Client ID and Client Secret is displayed. Save them in a safe place for later use.

    61f26f68840d8.png

You have successfully created the client credentials.

[Note] Publishing statuses

Testing: If you keep your project in the Testing status, you will be required to reauthorize your connection in Boost.space Integrator every week. To avoid weekly reauthorization, update the project status to In production.

In production: If you update your project to the In production status, you will not be required to reauthorize the connection weekly. To update your project’s status, go to the OAuth consent screen and click Publish app. If you see the notice Needs verification, you can choose whether to go through the Google verification process for the app or to connect to your unverified app. Currently connecting to unverified apps works in Boost.space Integrator, but we cannot guarantee the Google will allow connections to unverified apps for an indefinite period.

For more information regarding publishing statuses, refer to the Publishing status section of Google’s Setting up your OAuth consent screen help.

Connect Google Ads Campaign Management to Boost.space Integrator

To connect your Google Ads Campaign Management account to Boost.space Integrator you must obtain your Account or Customer ID.

  1. Log in to your Google Ads account.

  2. Copy the Customer ID number near your profile image at the top-right corner of the page. For example, 123-456-7890.

    Google_Ads_Campaign_Management_2.png
  3. Log in to your Boost.space Integrator account, add a Google Ads Campaign Management module to your scenario, and click Create a connection.

  4. Optional: In the Connection name field, enter a name for the connection.

  5. Enter the Customer ID copied in step 2.

  6. Optional: Click Show advanced settings and enter the client credentials of your custom app.

  7. Click the Sign in with Google button and select your Google account.

  8. Review the access information and click Allow.

You have successfully established the connection. You can now edit your scenario and add more Google Ads Campaign Management modules. If your connection needs reauthorization at any point, follow the connection renewal steps here.

Campaign

Watch Campaigns

Triggers when a campaign is created.

Connection

Establish a connection to your Google Ads Campaign Management account.

Account/Customer ID

Select the account or customer ID associated with the campaigns.

Limit

Set the maximum number of campaigns Boost.space Integrator returns during one scenario execution cycle.

Search Campaigns

Searches for campaigns.

Connection

Establish a connection to your Google Ads Campaign Management account.

Account/Customer ID

Select the account or customer ID associated with the campaigns.

Select a Method

Search by Filter

  • Select the filter from the drop-down menu.

Search by Google Ads Query Language

You can search for campaigns using Google Ads Query Language. For example: SELECT campaign.id FROM campaign.

Limit

Set the maximum number of campaigns Boost.space Integrator returns during one scenario execution cycle.

Get a Campaign

Gets a specified campaign.

Connection

Establish a connection to your Google Ads Campaign Management account.

Account/Customer ID

Select the account or customer ID associated with the campaign.

Campaign ID

Select the campaign ID of the campaign you want to get.

Update a Campaign

Updates an existing campaign.

Connection

Establish a connection to your Google Ads Campaign Management account.

Select a Method

Select a method and enter the details in the fields that auto-populate based on your selection.

Account/Customer ID

Select the account or customer ID associated with the campaign.

Campaign ID

Select the campaign ID of the campaign you want to update.

Ad group

Watch Ad Groups

Triggers when an ad group is created.

Connection

Establish a connection to your Google Ads Campaign Management account.

Account/Customer ID

Select the account or customer ID associated with your ad groups.

Limit

Set the maximum number of ad groups Boost.space Integrator returns during one scenario execution cycle.

Search Ad Groups

Searches for ad groups.

Connection

Establish a connection to your Google Ads Campaign Management account.

Account/Customer ID

Select the account or customer ID associated with your ad groups.

Select a Method

Search by Filter

Select the filter from the drop-down menu.

Search by Google Ads Query Language

You can search for ad groups using Google Ads Query Language. For example: SELECT campaign.id FROM campaign.

Limit

Set the maximum number of ad groups Boost.space Integrator returns during one scenario execution cycle.

Update an Ad Group Status

Updates an existing ad group status.

Connection

Establish a connection to your Google Ads Campaign Management account.

Account/Customer ID

Select the account or customer ID associated with your ad group.

Ad Group ID

Enter the ID of your ad group.

Status

Select the status you want to update your ad group to.

Enabled

Paused

Removed

Keyword

Watch Keywords

Triggers when a keyword is added.

Connection

Establish a connection to your Google Ads Campaign Management account.

Account/Customer ID

Select the account or customer ID associated with your keywords.

Limit

Set the maximum number of keywords Boost.space Integrator returns during one scenario execution cycle.

Search Keywords

Searches for keywords.

Connection

Establish a connection to your Google Ads Campaign Management account.

Account/Customer ID

Select the account or customer ID associated with your keywords.

Select a Method

Search by Filter

Select the filter from the drop-down menu.

Search by Google Ads Query Language

You can search for keywords using Google Ads Query Language. For example: SELECT campaign.id FROM campaign.

Limit

Set the maximum number of keywords Boost.space Integrator returns during one scenario execution cycle.

Update a Keyword Status

Updates an existing keyword status.

Connection

Establish a connection to your Google Ads Campaign Management account.

Account/Customer ID

Select the account or customer ID associated with your keyword.

Ad Group ID

Enter the ID of your keyword.

Status

Select the status you want to update your keyword to.

Enabled

Paused

Removed

Negative Shared List

Add a Negative Keyword to a Negative Keyword List

Adds a negative keyword to a specified negative keyword list.

Connection

Establish a connection to your Google Ads Campaign Management account.

Account/Customer ID

Select the account or customer ID associated with the negative keyword.

Negative Keyword List ID

Select the ID of your negative keyword list you want to add the negative keyword to.

Text

Enter the text of the keyword (at most 80 characters and 10 words).

Match Type

Select the keyword match type.

Broad

Phrase

Exact

Add a Placement to a Placement Exclusion List

Adds a placement to a placement exclusion list.

Connection

Establish a connection to your Google Ads Campaign Management account.

Account/Customer ID

Select the account or customer ID associated with the placement.

Negative Placement List ID

Select the ID of your negative placement list you want to add the placement to.

Negative Placement URL

Enter the URL of the negative placement. For example, https://www.domain.com.

Object

Search Objects

Searches for objects by Google Ads query language.

Connection

Establish a connection to your Google Ads Campaign Management account.

Account/Customer ID

Select the account or customer ID associated with your object.

Type

Select your desired search method and enter the details in the fields that populate based on your selection.

Limit

Set the maximum number of objects Boost.space Integrator returns during one scenario execution cycle.

Create an Object

Creates an new object.

Connection

Establish a connection to your Google Ads Campaign Management account.

Account/Customer ID

Select the account associated with the object you want to create.

Resource

Enter the resource ID or select one from the list. Enter the details in the fields that populate based on your selection.

Update an Object

Updates an existing object.

Connection

Establish a connection to your Google Ads Campaign Management account.

Account/Customer ID

Select the account associated with the object you want to update.

Resource

Enter the resource ID or select one from the list. Enter the details in the fields that populate based on your selection.

Object ID

Enter the ID of the object you want to update.

Delete an Object

Deletes an object.

Connection

Establish a connection to your Google Ads Campaign Management account.

Account/Customer ID

Select the account associated with the object you want to delete.

Resource

Select the resource ID from the list.

Object ID

Enter the ID of the object you want to delete.

Other

List Accounts

Retrieves a list of accounts.

Connection

Establish a connection to your Google Ads Campaign Management account.

Query

Use the Google Ads Query Language to get a list of the accounts you want.

Resource

Set the maximum number of accounts Boost.space Integrator returns during one scenario execution cycle.

Get an Account

Gets a specified account.

Connection

Establish a connection to your Google Ads Campaign Management account.

Account/Customer ID

Select or map the account ID whose details you want to retrieve.

Make an API Call

Performs an arbitrary authorized API call.

Connection

Establish a connection to your Google Ads Campaign Management account.

URL

Enter a path relative to https://googleads.googleapis.com. For example, /v9/customers/MY_CUSTOMER_ID

[Note] Note

For the list of available endpoints, refer to the Google Ads API Documentation.

Method

Select the HTTP method you want to use:

GET to retrieve information for an entry.

POST to create a new entry.

PUT to update/replace an existing entry.

PATCH to make a partial entry update.

DELETE to delete an entry.

Headers

Enter the desired request headers. You don’t have to add authorization headers; Boost.space Integrator already does that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of use – List Customers

The following API call returns all the customers from your Google Ads account:

URL: /v9/customers/MY_CUSTOMER_ID/

Method: GET

google_ads_campaign_management_1.png

Matches of the search can be found in the module’s Output under Bundle > Body. In our example, 1 customer was returned:

google_ads_campaign_management_2.png