> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Ads

> How to set up the Google Ads connector, plus the actions that are available.

![Google Ads](https://stackone-logos.com/api/google-ads/filled/svg)

Betav1.1.0[See changelog](https://docs.stackone.com/connectors/googleads/changelog.md)

[52 actions](#actions) · 2 auth methods

Advertising

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/googleads/guides/connector-profile/oauth-2-0.md)
>
> Requires an OAuth app in Google Cloud Console with the Google Ads API enabled, plus a developer token from a Google Ads...

> [card] [Service Account · Connector Profile](https://docs.stackone.com/connectors/googleads/guides/connector-profile/service-account.md)
>
> Uses a Google Cloud service account's JSON key instead of a user sign-in. The service account is added as a user on the...

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/googleads/guides/link-account/oauth-2-0.md)

> [card] [Service Account · Link Account](https://docs.stackone.com/connectors/googleads/guides/link-account/service-account.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

OAuth 2.0

Service Account

No auth methods found

Scopes

Select all
|
Clear

https\://​www\.googleapis.com/auth/adwords

No scopes found

52 actions

ActionDescriptionRequired scopes

Mutate Ad Groups`googleads_mutate_ad_groups`

Create, update, or remove ad groups in a Google Ads customer account

`https://​www.googleapis.com/auth/adwords`

Mutate Ad Group Ads`googleads_mutate_ad_group_ads`

Create, update, or remove ads within ad groups

`https://​www.googleapis.com/auth/adwords`

Mutate Ads`googleads_mutate_ads`

Update existing ads in a Google Ads customer account

`https://​www.googleapis.com/auth/adwords`

Mutate Ad Group Criteria`googleads_mutate_ad_group_criteria`

Create, update, or remove ad group criteria such as keywords and audiences

`https://​www.googleapis.com/auth/adwords`

Mutate Ad Group Bid Modifiers`googleads_mutate_ad_group_bid_modifiers`

Create, update, or remove ad group bid modifiers

`https://​www.googleapis.com/auth/adwords`

Mutate Ad Group Labels`googleads_mutate_ad_group_labels`

Attach labels to or remove labels from ad groups

`https://​www.googleapis.com/auth/adwords`

Mutate Ad Group Assets`googleads_mutate_ad_group_assets`

Link, update, or unlink assets at the ad group level

`https://​www.googleapis.com/auth/adwords`

Mutate Assets`googleads_mutate_assets`

Create or update assets in a Google Ads customer account

`https://​www.googleapis.com/auth/adwords`

Mutate Asset Groups`googleads_mutate_asset_groups`

Create, update, or remove asset groups in a Google Ads customer account

`https://​www.googleapis.com/auth/adwords`

Mutate Asset Group Assets`googleads_mutate_asset_group_assets`

Link assets to or unlink them from Performance Max asset groups

`https://​www.googleapis.com/auth/adwords`

Mutate User Lists`googleads_mutate_user_lists`

Create, update, or remove user lists (remarketing lists) in a Google Ads account

`https://​www.googleapis.com/auth/adwords`

Upload User Data`googleads_upload_user_data`

Upload or remove user data (Customer Match identifiers) for a customer

`https://​www.googleapis.com/auth/adwords`

Mutate Audiences`googleads_mutate_audiences`

Create or update audiences in a Google Ads account

`https://​www.googleapis.com/auth/adwords`

Mutate Custom Audiences`googleads_mutate_custom_audiences`

Create, update, or remove custom audiences in a Google Ads account

`https://​www.googleapis.com/auth/adwords`

Mutate Remarketing Actions`googleads_mutate_remarketing_actions`

Create or update remarketing actions (remarketing tags) in a Google Ads account

`https://​www.googleapis.com/auth/adwords`

Mutate Batch Jobs`googleads_mutate_batch_jobs`

Create or remove a batch job for asynchronous bulk mutates

`https://​www.googleapis.com/auth/adwords`

Add Batch Job Operations`googleads_add_batch_job_operations`

Add mutate operations to a pending batch job

`https://​www.googleapis.com/auth/adwords`

Run Batch Job`googleads_run_batch_job`

Start asynchronous execution of a batch job

`https://​www.googleapis.com/auth/adwords`

List Batch Job Results`googleads_list_batch_job_results`

List the results of a completed batch job (cursor paginated)

`https://​www.googleapis.com/auth/adwords`

List Invoices`googleads_list_invoices`

List invoices issued for a customer in a given month and billing setup

`https://​www.googleapis.com/auth/adwords`

List Payments Accounts`googleads_list_payments_accounts`

List all payments accounts associated with a customer

`https://​www.googleapis.com/auth/adwords`

Mutate Bidding Strategies`googleads_mutate_bidding_strategies`

Create, update, or remove portfolio bidding strategies in a Google Ads customer account

`https://​www.googleapis.com/auth/adwords`

Mutate Campaign Budgets`googleads_mutate_campaign_budgets`

Create, update, or remove campaign budgets in a single batch request

`https://​www.googleapis.com/auth/adwords`

Mutate Campaigns`googleads_mutate_campaigns`

Create, update, or remove campaigns in a single batch request

`https://​www.googleapis.com/auth/adwords`

Mutate Campaign Criteria`googleads_mutate_campaign_criteria`

Create, update, or remove campaign-level targeting criteria in a single batch request

`https://​www.googleapis.com/auth/adwords`

Mutate Campaign Assets`googleads_mutate_campaign_assets`

Create, update, or remove campaign-asset links in a single batch request

`https://​www.googleapis.com/auth/adwords`

Mutate Campaign Labels`googleads_mutate_campaign_labels`

Attach labels to or detach labels from campaigns in a single batch request

`https://​www.googleapis.com/auth/adwords`

Mutate Campaign Shared Sets`googleads_mutate_campaign_shared_sets`

Attach shared sets to or detach shared sets from campaigns in a single batch request

`https://​www.googleapis.com/auth/adwords`

Mutate Conversion Actions`googleads_mutate_conversion_actions`

Create, update, or remove conversion actions in a Google Ads account

`https://​www.googleapis.com/auth/adwords`

Upload Click Conversions`googleads_upload_click_conversions`

Upload offline click conversions attributed to Google Ads clicks

`https://​www.googleapis.com/auth/adwords`

Upload Call Conversions`googleads_upload_call_conversions`

Upload offline call conversions matched by caller ID and call start time

`https://​www.googleapis.com/auth/adwords`

Upload Conversion Adjustments`googleads_upload_conversion_adjustments`

Upload adjustments (restatements or retractions) for previously reported conversions

`https://​www.googleapis.com/auth/adwords`

Create Offline User Data Job`googleads_create_offline_user_data_job`

Create an offline user data job for Customer Match or Store Sales uploads

`https://​www.googleapis.com/auth/adwords`

Add Offline User Data Job Operations`googleads_add_offline_user_data_job_operations`

Add user data operations to a pending offline user data job

`https://​www.googleapis.com/auth/adwords`

Run Offline User Data Job`googleads_run_offline_user_data_job`

Start asynchronous processing of an offline user data job

`https://​www.googleapis.com/auth/adwords`

List Accessible Customers`googleads_list_accessible_customers`

List the resource names of Google Ads customers directly accessible by the authenticated user

`https://​www.googleapis.com/auth/adwords`

Create Customer Client`googleads_create_customer_client`

Create a new client account under a manager (MCC) account

`https://​www.googleapis.com/auth/adwords`

Mutate Customers`googleads_mutate_customers`

Update account-level settings of a Google Ads customer

`https://​www.googleapis.com/auth/adwords`

Generate Keyword Ideas`googleads_generate_keyword_ideas`

Generate keyword ideas from seed keywords, a URL, or a site (cursor paginated)

`https://​www.googleapis.com/auth/adwords`

Generate Keyword Historical Metrics`googleads_generate_keyword_historical_metrics`

Retrieve historical search volume and competition metrics for a list of keywords

`https://​www.googleapis.com/auth/adwords`

Generate Keyword Forecast Metrics`googleads_generate_keyword_forecast_metrics`

Forecast clicks, impressions, and cost for a hypothetical keyword campaign

`https://​www.googleapis.com/auth/adwords`

Suggest Geo Target Constants`googleads_suggest_geo_target_constants`

Look up geo target constants by location names or by geo target resource names

`https://​www.googleapis.com/auth/adwords`

Mutate Labels`googleads_mutate_labels`

Create, update, or remove labels in a Google Ads customer account

`https://​www.googleapis.com/auth/adwords`

Apply Recommendations`googleads_apply_recommendations`

Apply Google Ads recommendations such as budget, keyword, or bidding suggestions

`https://​www.googleapis.com/auth/adwords`

Dismiss Recommendations`googleads_dismiss_recommendations`

Dismiss Google Ads recommendations so they no longer appear for the account

`https://​www.googleapis.com/auth/adwords`

Generate Recommendations`googleads_generate_recommendations`

Generate recommendations on demand for a campaign being constructed or edited

`https://​www.googleapis.com/auth/adwords`

Search Google Ads`googleads_search_google_ads`

Run a GAQL query to fetch resources, metrics, and reports (cursor paginated)

`https://​www.googleapis.com/auth/adwords`

Search Stream`googleads_search_stream`

Run a GAQL query and stream all matching rows in a single response

`https://​www.googleapis.com/auth/adwords`

Search Google Ads Fields`googleads_search_google_ads_fields`

Search the GoogleAdsField metadata catalog to discover queryable fields

`https://​www.googleapis.com/auth/adwords`

Mutate Shared Sets`googleads_mutate_shared_sets`

Create, update, or remove shared sets (shared negative keyword or placement lists)

`https://​www.googleapis.com/auth/adwords`

Mutate Shared Criteria`googleads_mutate_shared_criteria`

Create or remove criteria (negative keywords or placements) within shared sets

`https://​www.googleapis.com/auth/adwords`

Mutate Customer Negative Criteria`googleads_mutate_customer_negative_criteria`

Create or remove account-level negative criteria (content and placement exclusions)

`https://​www.googleapis.com/auth/adwords`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.