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

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Google Ads

> Manage and report on Google Ads customers, campaigns, creative, conversions, audiences, and change events.

Use the Google Ads integration to operate paid campaigns and turn account changes into typed automation inputs. Automate.ax handles OAuth, the platform developer token, manager headers, pagination, retries, and polling.

## Exports

```ts theme={null}
import { googleAds, googleAccount } from "automate.ax/google-ads"
```

* `googleAds` contains the packaged actions and triggers.
* `googleAccount("name")` selects a named Google connection.

## Account hierarchy

Use `listAccessibleCustomers` to find accounts directly available to the OAuth identity. Use `listCustomerClients` to traverse a manager account. For calls to a managed client, set `customerId` to the client and `loginCustomerId` to the manager. Customer IDs accept the displayed dashed form or 10 digits.

## Triggers

* [On change](/reference/integrations/google-ads/triggers/on-change)
* [On campaign created](/reference/integrations/google-ads/triggers/on-campaign-created)
* [On campaign updated](/reference/integrations/google-ads/triggers/on-campaign-updated)
* [On campaign removed](/reference/integrations/google-ads/triggers/on-campaign-removed)
* [On campaign budget created](/reference/integrations/google-ads/triggers/on-campaign-budget-created)
* [On campaign budget updated](/reference/integrations/google-ads/triggers/on-campaign-budget-updated)
* [On campaign budget removed](/reference/integrations/google-ads/triggers/on-campaign-budget-removed)
* [On ad group created](/reference/integrations/google-ads/triggers/on-ad-group-created)
* [On ad group updated](/reference/integrations/google-ads/triggers/on-ad-group-updated)
* [On ad group removed](/reference/integrations/google-ads/triggers/on-ad-group-removed)
* [On ad created](/reference/integrations/google-ads/triggers/on-ad-group-ad-created)
* [On ad updated](/reference/integrations/google-ads/triggers/on-ad-group-ad-updated)
* [On ad removed](/reference/integrations/google-ads/triggers/on-ad-group-ad-removed)
* [On ad-group asset linked](/reference/integrations/google-ads/triggers/on-ad-group-asset-created)
* [On ad-group asset updated](/reference/integrations/google-ads/triggers/on-ad-group-asset-updated)
* [On ad-group asset unlinked](/reference/integrations/google-ads/triggers/on-ad-group-asset-removed)
* [On asset created](/reference/integrations/google-ads/triggers/on-asset-created)
* [On asset updated](/reference/integrations/google-ads/triggers/on-asset-updated)
* [On asset removed](/reference/integrations/google-ads/triggers/on-asset-removed)
* [On campaign asset linked](/reference/integrations/google-ads/triggers/on-campaign-asset-created)
* [On campaign asset updated](/reference/integrations/google-ads/triggers/on-campaign-asset-updated)
* [On campaign asset unlinked](/reference/integrations/google-ads/triggers/on-campaign-asset-removed)

## Actions

* [Create Ad Group](/reference/integrations/google-ads/actions/create-ad-group)
* [Create Audience](/reference/integrations/google-ads/actions/create-audience)
* [Create Campaign](/reference/integrations/google-ads/actions/create-campaign)
* [Create Campaign Budget](/reference/integrations/google-ads/actions/create-campaign-budget)
* [Create Conversion Action](/reference/integrations/google-ads/actions/create-conversion-action)
* [Create Asset](/reference/integrations/google-ads/actions/create-asset)
* [Create Responsive Search Ad](/reference/integrations/google-ads/actions/create-responsive-search-ad)
* [Create User List](/reference/integrations/google-ads/actions/create-user-list)
* [Get Ad Group Performance](/reference/integrations/google-ads/actions/get-ad-group-performance)
* [Get Ad Performance](/reference/integrations/google-ads/actions/get-ad-performance)
* [Get Campaign Performance](/reference/integrations/google-ads/actions/get-campaign-performance)
* [Get Conversion Performance](/reference/integrations/google-ads/actions/get-conversion-performance)
* [Get Customer](/reference/integrations/google-ads/actions/get-customer)
* [Link Ad Group Asset](/reference/integrations/google-ads/actions/link-ad-group-asset)
* [Link Campaign Asset](/reference/integrations/google-ads/actions/link-campaign-asset)
* [List Accessible Customers](/reference/integrations/google-ads/actions/list-accessible-customers)
* [List Ad Group Ads](/reference/integrations/google-ads/actions/list-ad-group-ads)
* [List Ad Groups](/reference/integrations/google-ads/actions/list-ad-groups)
* [List Assets](/reference/integrations/google-ads/actions/list-assets)
* [List Audiences](/reference/integrations/google-ads/actions/list-audiences)
* [List Campaign Budgets](/reference/integrations/google-ads/actions/list-campaign-budgets)
* [List Campaigns](/reference/integrations/google-ads/actions/list-campaigns)
* [List Conversion Actions](/reference/integrations/google-ads/actions/list-conversion-actions)
* [List Customer Clients](/reference/integrations/google-ads/actions/list-customer-clients)
* [List User Lists](/reference/integrations/google-ads/actions/list-user-lists)
* [Query Report](/reference/integrations/google-ads/actions/query-report)
* [Remove Ad Group](/reference/integrations/google-ads/actions/remove-ad-group)
* [Remove Ad Group Ad](/reference/integrations/google-ads/actions/remove-ad-group-ad)
* [Remove Campaign](/reference/integrations/google-ads/actions/remove-campaign)
* [Remove Campaign Budget](/reference/integrations/google-ads/actions/remove-campaign-budget)
* [Remove Conversion Action](/reference/integrations/google-ads/actions/remove-conversion-action)
* [Remove User List](/reference/integrations/google-ads/actions/remove-user-list)
* [Unlink Ad Group Asset](/reference/integrations/google-ads/actions/unlink-ad-group-asset)
* [Unlink Campaign Asset](/reference/integrations/google-ads/actions/unlink-campaign-asset)
* [Update Ad Group](/reference/integrations/google-ads/actions/update-ad-group)
* [Update Ad Group Ad Status](/reference/integrations/google-ads/actions/update-ad-group-ad-status)
* [Update Ad Group Asset](/reference/integrations/google-ads/actions/update-ad-group-asset)
* [Update Asset Name](/reference/integrations/google-ads/actions/update-asset-name)
* [Update Audience](/reference/integrations/google-ads/actions/update-audience)
* [Update Campaign](/reference/integrations/google-ads/actions/update-campaign)
* [Update Campaign Asset](/reference/integrations/google-ads/actions/update-campaign-asset)
* [Update Campaign Budget](/reference/integrations/google-ads/actions/update-campaign-budget)
* [Update Conversion Action](/reference/integrations/google-ads/actions/update-conversion-action)
* [Update User List](/reference/integrations/google-ads/actions/update-user-list)
* [Upload Call Conversions](/reference/integrations/google-ads/actions/upload-call-conversions)
* [Upload Click Conversions](/reference/integrations/google-ads/actions/upload-click-conversions)
* [Upload Conversion Adjustments](/reference/integrations/google-ads/actions/upload-conversion-adjustments)
* [Upload User List Members](/reference/integrations/google-ads/actions/upload-user-list-members)

## Provider behavior

Google Ads reports use GAQL. Search responses contain fixed 10,000-row pages; continue with `nextPageToken` and the identical query. Mutations return resource names. Provider quotas and access levels apply, and errors include Google's request ID when available.

Change triggers don't form a complete audit log. Google omits Ads Editor and criterion-level changes, and some rows visible in Change History have no ChangeEvent. Use Google's change-status reporting when you need those changes.