# Google Ads API Documentation

This is the complete API documentation for connecting to the Google Ads API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **Google Ads connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/googleAds/actions/{actionSlug}/run
```

## Google Ads actions

- POST `add-campaign-criterion` Add Campaign Criterion
- POST `add-keyword-criterion` Add Keyword Criterion
- POST `add-lead-feedback` Add Lead Feedback
- POST `add-negative-campaign-keyword` Add Negative Campaign Keyword
- PUT `add-offline-user-data-job-operations` Add Offline User Data Job Operations
- POST `attach-ad-group-ad-label` Attach Ad Group Ad Label
- POST `attach-ad-group-label` Attach Ad Group Label
- POST `attach-campaign-label` Attach Campaign Label
- POST `attach-keyword-label` Attach Keyword Label
- POST `create-ad-group` Create Ad Group
- POST `create-campaign` Create Campaign
- POST `create-campaign-budget` Create Campaign Budget
- POST `create-customer-client` Create Customer Client
- POST `create-offline-user-data-job` Create Offline User Data Job
- POST `create-responsive-search-ad` Create Responsive Search Ad
- DELETE `detach-ad-group-ad-label` Detach Ad Group Ad Label
- DELETE `detach-ad-group-label` Detach Ad Group Label
- DELETE `detach-campaign-label` Detach Campaign Label
- DELETE `detach-keyword-label` Detach Keyword Label
- PUT `enable-ad-group` Enable Ad Group
- PUT `enable-ad-group-ad` Enable Ad Group Ad
- PUT `enable-campaign` Enable Campaign
- PUT `enable-keyword-criterion` Enable Keyword Criterion
- GET `generate-ad-group-themes` Generate Ad Group Themes
- GET `generate-keyword-forecast-metrics` Generate Keyword Forecast Metrics
- GET `generate-keyword-historical-metrics` Generate Keyword Historical Metrics
- GET `generate-keyword-ideas` Generate Keyword Ideas
- GET `generate-recommendations` Generate Recommendations
- GET `get-ad-group-performance` Get Ad Group Performance
- GET `get-ad-performance` Get Ad Performance
- GET `get-asset-performance-report` Get Asset Performance Report
- GET `get-audience-segment-performance-report` Get Audience Segment Performance Report
- GET `get-budget-pacing-report` Get Budget Pacing Report
- GET `get-campaign-daily-trend-report` Get Campaign Daily Trend Report
- GET `get-conversion-action-performance-report` Get Conversion Action Performance Report
- GET `get-customer-overview` Get Customer Overview
- GET `get-day-and-hour-performance-report` Get Day and Hour Performance Report
- GET `get-device-performance-report` Get Device Performance Report
- GET `get-geo-performance-report` Get Geo Performance Report
- GET `get-keyword-performance` Get Keyword Performance
- GET `get-landing-page-performance-report` Get Landing Page Performance Report
- GET `get-local-services-lead` Get Local Services Lead
- GET `get-recommendation` Get Recommendation
- GET `get-user-list` Get User List
- GET `list-accessible-customers` List Accessible Customers
- GET `list-account-budget-proposals` List Account Budget Proposals
- GET `list-account-budgets` List Account Budgets
- GET `list-account-change-events` List Account Change Events
- GET `list-account-change-status` List Account Change Status
- GET `list-account-labels` List Account Labels
- GET `list-billing-setups` List Billing Setups
- GET `list-customer-client-hierarchy` List Customer Client Hierarchy
- GET `list-customer-client-links` List Customer Client Links
- GET `list-customer-label-assignments` List Customer Label Assignments
- GET `list-customer-manager-links` List Customer Manager Links
- GET `list-customer-user-access` List Customer User Access
- GET `list-customer-user-access-invitations` List Customer User Access Invitations
- GET `list-invoices` List Invoices
- GET `list-local-services-leads` List Local Services Leads
- GET `list-recommendations` List Recommendations
- PUT `mutate-ad-group-assets` Mutate Ad Group Assets
- PUT `mutate-asset-set-assets` Mutate Asset Set Assets
- PUT `mutate-asset-sets` Mutate Asset Sets
- PUT `mutate-assets` Mutate Assets
- PUT `mutate-campaign-asset-sets` Mutate Campaign Asset Sets
- PUT `mutate-campaign-assets` Mutate Campaign Assets
- PUT `mutate-conversion-actions` Mutate Conversion Actions
- PUT `mutate-conversion-custom-variables` Mutate Conversion Custom Variables
- PUT `mutate-customer-assets` Mutate Customer Assets
- PUT `mutate-customer-conversion-goals` Mutate Customer Conversion Goals
- PUT `mutate-resources` Mutate Resources
- PUT `mutate-user-lists` Mutate User Lists
- PUT `pause-ad-group` Pause Ad Group
- PUT `pause-ad-group-ad` Pause Ad Group Ad
- PUT `pause-campaign` Pause Campaign
- PUT `pause-keyword-criterion` Pause Keyword Criterion
- DELETE `remove-ad-group` Remove Ad Group
- DELETE `remove-ad-group-ad` Remove Ad Group Ad
- DELETE `remove-campaign` Remove Campaign
- DELETE `remove-campaign-criterion` Remove Campaign Criterion
- DELETE `remove-keyword-criterion` Remove Keyword Criterion
- PUT `run-offline-user-data-job` Run Offline User Data Job
- GET `search-google-ads` Search Google Ads
- GET `search-terms-report` Search Terms Report
- PUT `update-ad-group` Update Ad Group
- PUT `update-campaign` Update Campaign
- PUT `update-campaign-budget` Update Campaign Budget
- PUT `update-campaign-criterion` Update Campaign Criterion
- PUT `update-keyword-criterion` Update Keyword Criterion
- PUT `update-responsive-search-ad` Update Responsive Search Ad
- POST `upload-call-conversions` Upload Call Conversions
- POST `upload-click-conversions` Upload Click Conversions
- PUT `upload-conversion-adjustments` Upload Conversion Adjustments