> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Google Ads connector

- Connector: `appmixer.googleAds`
- Version: 1.3.3
- Components: 11 (0 triggers, 11 actions)

Google Ads connector for Customer Match workflows, user list management, and offline user data jobs.

- Connector page: <https://connectors.appmixer.com/connector/appmixer.googleAds/1.3.3>
- Source code: <https://github.com/clientIO/appmixer-connectors/tree/dev/src/appmixer/googleAds>
- Download package: <https://connectors.appmixer.com/connector/appmixer.googleAds/1.3.3/download>

## Authentication

**Type:** OAuth 2

This connector is globally authenticated and verified by Appmixer (Authentication Hub) and is ready to use without registering your own OAuth application with the provider. You can still use your own OAuth credentials (clientId and clientSecret) - see the Connector Configuration section of the documentation. The Authentication Hub is enabled for all hosted Appmixer tenants; on self-managed installations it has to be explicitly set.

**Scopes:**

- `profile`
- `email`

## Actions (11)

- [Add User To User List](https://connectors.appmixer.com/connector/appmixer.googleAds/1.3.3/component/appmixer.googleAds.core.AddUserToUserList.md) (`appmixer.googleAds.core.AddUserToUserList`): Adds or removes a single user from a Customer Match user list via UserDataService.UploadUserData. Best for sporadic, real-time updates (e.g. CRM webhook). Limit: 1 user per call. Note: updates do not appear in the Google Ads UI upload history. Additional scopes: `https://www.googleapis.com/auth/adwords`.
- [Add Users From C S V To User List](https://connectors.appmixer.com/connector/appmixer.googleAds/1.3.3/component/appmixer.googleAds.core.AddUsersFromCSVToUserList.md) (`appmixer.googleAds.core.AddUsersFromCSVToUserList`): Upload a CSV file of users to a Google Ads Customer Match user list via the Offline User Data Job API. Supports large files by processing them in batches across multiple continuations. Provide a schema mapping for each upload so different CSV headers can be mapped explicitly. Additional scopes: `https://www.googleapis.com/auth/adwords`.
- [Create User List](https://connectors.appmixer.com/connector/appmixer.googleAds/1.3.3/component/appmixer.googleAds.core.CreateUserList.md) (`appmixer.googleAds.core.CreateUserList`): Creates a CRM-based Google Ads user list for Customer Match uploads. Additional scopes: `https://www.googleapis.com/auth/adwords`.
- [Delete User List](https://connectors.appmixer.com/connector/appmixer.googleAds/1.3.3/component/appmixer.googleAds.core.DeleteUserList.md) (`appmixer.googleAds.core.DeleteUserList`): Deletes a Google Ads user list by ID or resource name. Additional scopes: `https://www.googleapis.com/auth/adwords`.
- [Find User Lists](https://connectors.appmixer.com/connector/appmixer.googleAds/1.3.3/component/appmixer.googleAds.core.FindUserLists.md) (`appmixer.googleAds.core.FindUserLists`): Finds up to 200 Google Ads user lists for a customer account with optional filtering. Additional scopes: `https://www.googleapis.com/auth/adwords`.
- [Get User List](https://connectors.appmixer.com/connector/appmixer.googleAds/1.3.3/component/appmixer.googleAds.core.GetUserList.md) (`appmixer.googleAds.core.GetUserList`): Gets a single Google Ads user list by ID. Additional scopes: `https://www.googleapis.com/auth/adwords`.
- [List Accessible Customers](https://connectors.appmixer.com/connector/appmixer.googleAds/1.3.3/component/appmixer.googleAds.core.ListAccessibleCustomers.md) (`appmixer.googleAds.core.ListAccessibleCustomers`): Lists Google Ads customers accessible by the authenticated user. Additional scopes: `https://www.googleapis.com/auth/adwords`.
- [Make Api Call](https://connectors.appmixer.com/connector/appmixer.googleAds/1.3.3/component/appmixer.googleAds.core.MakeApiCall.md) (`appmixer.googleAds.core.MakeApiCall`): Performs an arbitrary authorized API call to the Google Ads API. Additional scopes: `https://www.googleapis.com/auth/adwords`.
- [Remove User From User List](https://connectors.appmixer.com/connector/appmixer.googleAds/1.3.3/component/appmixer.googleAds.core.RemoveUserFromUserList.md) (`appmixer.googleAds.core.RemoveUserFromUserList`): Removes a single user from a Customer Match user list via UserDataService.UploadUserData. Best for sporadic, real-time updates (e.g. CRM webhook). Limit: 1 user per call. Note: updates do not appear in the Google Ads UI upload history. Additional scopes: `https://www.googleapis.com/auth/adwords`.
- [Remove Users In C S V From User List](https://connectors.appmixer.com/connector/appmixer.googleAds/1.3.3/component/appmixer.googleAds.core.RemoveUsersInCSVFromUserList.md) (`appmixer.googleAds.core.RemoveUsersInCSVFromUserList`): Remove users listed in a CSV file from a Google Ads Customer Match user list via the Offline User Data Job API. Supports large files by processing them in batches across multiple continuations. Provide a schema mapping for each upload so different CSV headers can be mapped explicitly. Additional scopes: `https://www.googleapis.com/auth/adwords`.
- [Update User List](https://connectors.appmixer.com/connector/appmixer.googleAds/1.3.3/component/appmixer.googleAds.core.UpdateUserList.md) (`appmixer.googleAds.core.UpdateUserList`): Updates properties of an existing Customer Match user list (name, description, membership life span, integration code, etc.). Additional scopes: `https://www.googleapis.com/auth/adwords`.

## Changelog

### 1.3.3

- Security: upgraded csv-parse to 7.0.3 (GHSA-8cw4-87c7-c6xx, prototype replacement via the columns option). No change to how the user list CSV files are read.

### 1.3.2

- Quote CSV cells that hold a comma, a double quote or a line break and map cells by header column when exporting results to a file.

### 1.3.1

- MakeApiCall: Request Headers and Query Parameters set in the Designer are now sent. They were silently dropped: the key-value field stores its rows as a JSON object string, which the component did not parse.

### 1.3.0

- Added MakeApiCall component for performing arbitrary authorized API calls to the Google Ads API.

### 1.2.2

- Added output examples to component schemas.

### 1.2.0

- Added explicit schema mapping for CSV uploads.

### 1.1.0

- Added support for uploading and removing users to Google Ads user lists from CSV files via two new components.

### 1.0.0

- Initial Google Ads release with user list and Customer Match workflow components.
