> ## Documentation Index > Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Google Ads > Set up and use the Google Ads integration with Hyper AI Auth type: OAuth For setup fundamentals and permissions, start here: [App Integrations](/integrations/overview). ## Connect Google Ads 1. Go to Settings → Apps in Hyper 2. Select Google Ads → Connect New 3. Complete OAuth and choose the correct ad account ## Common capabilities * Read campaign/ad group performance * Propose budgets and bid strategies * Draft new ad copy and variations ## Use in Chat Enable Google Ads and ask for performance summaries or draft campaigns. ## Use in Agents Add Google Ads to toolkits; require approval for write/publish actions. ## Use in Flows Automate reporting and experimentation across campaigns. ## Troubleshooting * Wrong account: reconnect and select the intended customer account * Insufficient scopes: reauthorize with required permissions *** ## Available Actions Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings. Actions can be set to one of three control states: | State | Behavior | | --------------------- | -------------------------------------------------------------- | | **Enabled** | Agent runs the action automatically | | **Requires Approval** | Agent pauses and waits for your confirmation before proceeding | | **Disabled** | Action is blocked and cannot be used | Configure these in the agent's toolkit settings or in workspace defaults. | Action | Description | | ----------------------------- | ------------------------------------------------------------------------------- | | Add Audience Target | Add audience targeting to a Google Ads ad group | | Add Location Target | Add location targeting to a Google Ads campaign | | Create Ad | Create a new ad in an ad group | | Create Ad Group | Create a new Google Ads ad group within an existing campaign | | Create Budget | Create a new Google Ads campaign budget | | Create Campaign | Create a new Google Ads campaign with budget | | Create From Blueprint | Create a full Google Ads campaign (budget + campaign + locations + | | Create From Pmax Blueprint | Create a full Performance Max campaign (budget + campaign + locations + | | Create Keyword | Add a keyword to a Google Ads ad group | | Delete Ad | Delete an ad from an ad group | | Delete Ad Group | Delete (remove) a Google Ads ad group | | Delete Keyword | Delete (remove) a keyword from a Google Ads ad group | | Execute Gaql | Execute a Google Ads Query Language (GAQL) query | | Get Ad Performance | Get ad performance metrics for specific campaigns and ad groups | | Get Asset | Get a single asset by id | | Get Campaign Performance | Get campaign performance metrics for a specific time period | | Get Health Check | | | Link Asset | Alias of google\_ads\_link\_asset\_smart | | Link Asset Smart | | | Link Asset To Ad | Link an asset to a specific RSA ad (HEADLINE or DESCRIPTION) | | Link Asset To Asset Group | Link an asset to a PMax asset group (field\_type e.g., MARKETING\_IMAGE) | | Link Asset To Campaign | Link an asset to a campaign (field\_type, e.g., IMAGE) | | List Accounts | List all accessible Google Ads accounts | | List Ad Groups | List ad groups for a campaign | | List Asset Groups | List asset groups for a Performance Max campaign | | List Assets | List assets for a customer (optionally filter by type) | | List Audience Targets | List all audience targets for a Google Ads ad group | | List Campaigns | List campaigns for a given customer id | | List Keywords | List all keywords in a Google Ads ad group | | List Location Targets | List all location targets for a Google Ads campaign | | List My Campaigns | List campaigns for the best default accessible account (no customer\_id needed) | | List Rsa Ads | List Responsive Search Ads in an ad group | | Preview Blueprint | Preview and validate a full Google Ads campaign blueprint BEFORE | | Preview Pmax Blueprint | Preview and validate a Performance Max campaign blueprint BEFORE | | Remove Audience Target | Remove audience targeting from a Google Ads ad group | | Remove Location Target | Remove location targeting from a Google Ads campaign | | Run Gaql | Run a custom GAQL query with flexible formatting options | | Run Health Check | Run a health check on all Google Ads accounts for this integration | | Search Audiences | Search for available audiences and user lists to use in targeting | | Search Locations | Search for location IDs to use in location targeting | | Unlink Asset | Alias of google\_ads\_unlink\_asset\_smart | | Unlink Asset From Ad | Unlink an asset from a specific RSA ad | | Unlink Asset From Asset Group | Unlink an asset from a PMax asset group | | Unlink Asset From Campaign | Unlink an asset from a campaign (requires same field\_type used when linking) | | Unlink Asset Smart | | | Update Ad | Update an existing ad in an ad group | | Update Ad Group | Update an existing Google Ads ad group (status, name, or bidding) | | Update Campaign | Update a campaign (status, name, dates, bidding, network settings) | | Update Keyword | Update an existing keyword in a Google Ads ad group | | Upload Image Asset | Upload an image asset (accepts image\_url or image\_base64) |