> ## Documentation Index
> Fetch the complete documentation index at: https://nango-wari-migrated-bigcommerce-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Ads

> Integrate your application with the Google Ads API

## 🚀 Quickstart

Connect to Google Ads with Nango and see data flow in 2 minutes.

<Steps>
  <Step title="Create the integration">
    In Nango ([free signup](https://app.nango.dev)), go to [Integrations](https://app.nango.dev/dev/integrations) -> *Configure New Integration* -> *Google Ads*. Nango doesn't provide a test OAuth app for Google Ads yet. You'll need to set up your own by following the setup guide linked below. After that, make sure to add the OAuth client ID, secret, and scopes in the integration settings in Nango.
  </Step>

  <Step title="Authorize Google Ads">
    Go to [Connections](https://app.nango.dev/dev/connections) -> *Add Test Connection* -> *Authorize*, then log in to Google. Later, you'll let your users do the same directly from your app.
  </Step>

  <Step title="Call the Google Ads API">
    Let's make your first request to the Google Ads API. Replace the placeholders below with your [secret key](https://app.nango.dev/dev/environment-settings), [integration ID](https://app.nango.dev/dev/integrations), and [connection ID](https://app.nango.dev/dev/connections):

    <Tabs>
      <Tab title="cURL">
        ```bash theme={null}
        curl "https://api.nango.dev/proxy/googleads/v17/customers" \
          -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
          -H "Provider-Config-Key: <INTEGRATION-ID>" \
          -H "Connection-Id: <CONNECTION-ID>"
        ```
      </Tab>

      <Tab title="Node">
        Install Nango's backend SDK with `npm i @nangohq/node`. Then run:

        ```typescript theme={null}
        import { Nango } from '@nangohq/node';

        const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

        const res = await nango.get({
            endpoint: '/googleads/v17/customers',
            providerConfigKey: '<INTEGRATION-ID>',
            connectionId: '<CONNECTION-ID>'
        });

        console.log(res.data);
        ```
      </Tab>
    </Tabs>

    Or fetch credentials with the [Node SDK](/reference/sdks/node#get-a-connection-with-credentials) or [API](/reference/api/connection/get).

    ✅ You're connected! Check the [Logs](https://app.nango.dev/dev/logs) tab in Nango to inspect requests.
  </Step>

  <Step title="Implement Nango in your app">
    Follow our [Auth implementation guide](/guides/primitives/auth) to integrate Nango in your app.

    To obtain your own production credentials, follow the setup guide linked below.
  </Step>
</Steps>

## 📚 Google Ads Integration Guides

Nango maintained guides for common use cases.

* [How to register your own Google Ads OAuth app](/api-integrations/google-ads/how-to-register-your-own-google-ads-api-oauth-app)\
  Register an OAuth app with Google for Google Ads and obtain credentials to connect it to Nango

* [Google App & Security Review](/api-integrations/google-shared/google-security-review)
  Pass Google's OAuth app verification to go to production

Official docs: [Google Ads API Documentation](https://developers.google.com/google-ads/api/docs/start)

## 🧩 Pre-built syncs & actions for Google Ads

Enable them in your dashboard. Extend and customize to fit your needs.

### Others

| Function name                        | Description                                                                                                     | Type                                           | Source code                                                                                                                                   |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `create-ad-group-ad`                 | Create an ad inside an ad group.                                                                                | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/create-ad-group-ad.ts)                 |
| `create-ad-group`                    | Create an ad group in an existing Google Ads campaign                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/create-ad-group.ts)                    |
| `create-campaign-budget`             | Create a campaign budget for one or more campaigns.                                                             | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/create-campaign-budget.ts)             |
| `create-campaign-location-criterion` | Add geographic location targeting to a campaign using a geo target constant.                                    | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/create-campaign-location-criterion.ts) |
| `create-campaign-negative-keyword`   | Add a negative keyword criterion at the campaign level.                                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/create-campaign-negative-keyword.ts)   |
| `create-campaign`                    | Create a campaign that references an existing budget.                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/create-campaign.ts)                    |
| `create-conversion-action`           | Create a conversion action for tracking conversions.                                                            | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/create-conversion-action.ts)           |
| `create-keyword-criterion`           | Add a positive keyword criterion to an ad group.                                                                | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/create-keyword-criterion.ts)           |
| `create-negative-keyword`            | Add a negative keyword criterion to an ad group so its ads stop showing for that term.                          | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/create-negative-keyword.ts)            |
| `generate-keyword-ideas`             | Generate keyword ideas and search volume/competition metrics from a seed keyword list or URL.                   | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/generate-keyword-ideas.ts)             |
| `list-accessible-customers`          | List customer accounts directly accessible to the authenticated user.                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/list-accessible-customers.ts)          |
| `remove-ad-group-ad`                 | Remove an ad from an ad group by resource name.                                                                 | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/remove-ad-group-ad.ts)                 |
| `remove-ad-group`                    | Remove an ad group by resource name.                                                                            | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/remove-ad-group.ts)                    |
| `remove-campaign-budget`             | Remove an unused campaign budget by resource name.                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/remove-campaign-budget.ts)             |
| `remove-campaign-criterion`          | Remove a campaign-level criterion (negative keyword or location target) by resource name.                       | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/remove-campaign-criterion.ts)          |
| `remove-campaign`                    | Remove a campaign by resource name.                                                                             | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/remove-campaign.ts)                    |
| `remove-conversion-action`           | Remove a conversion action by resource name.                                                                    | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/remove-conversion-action.ts)           |
| `remove-keyword-criterion`           | Remove a keyword criterion from an ad group.                                                                    | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/remove-keyword-criterion.ts)           |
| `search-google-ads`                  | Run a GAQL query and return paged Google Ads rows.                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/search-google-ads.ts)                  |
| `search-stream-google-ads`           | Run a GAQL query with streamed results                                                                          | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/search-stream-google-ads.ts)           |
| `suggest-geo-target-constants`       | Look up geo target constant resource names for location names or codes, for use in campaign location targeting. | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/suggest-geo-target-constants.ts)       |
| `update-ad-group-ad`                 | Update mutable fields on an ad group ad                                                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/update-ad-group-ad.ts)                 |
| `update-ad-group`                    | Update mutable fields on an ad group.                                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/update-ad-group.ts)                    |
| `update-campaign-budget`             | Update mutable fields on a campaign budget.                                                                     | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/update-campaign-budget.ts)             |
| `update-campaign`                    | Update mutable campaign settings.                                                                               | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/update-campaign.ts)                    |
| `update-conversion-action`           | Update mutable fields on a conversion action                                                                    | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/update-conversion-action.ts)           |
| `update-keyword-criterion`           | Update mutable fields on an ad group keyword criterion.                                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/update-keyword-criterion.ts)           |
| `validate-google-ads-mutate`         | Validate a mutate request without applying changes.                                                             | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/actions/validate-google-ads-mutate.ts)         |
| `accessible-customers`               | Sync directly accessible Google Ads customer accounts                                                           | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/syncs/accessible-customers.ts)                 |
| `ad-group-ads`                       | Sync ad group ads for customer accounts in scope.                                                               | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/syncs/ad-group-ads.ts)                         |
| `ad-groups`                          | Sync ad groups for customer accounts in scope.                                                                  | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/syncs/ad-groups.ts)                            |
| `campaign-budgets`                   | Sync campaign budgets for customer accounts in scope                                                            | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/syncs/campaign-budgets.ts)                     |
| `campaign-criteria`                  | Sync campaign-level criteria (negative keywords and location targeting) for customer accounts in scope.         | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/syncs/campaign-criteria.ts)                    |
| `campaigns`                          | Sync campaigns for customer accounts in scope.                                                                  | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/syncs/campaigns.ts)                            |
| `conversion-actions`                 | Sync conversion actions configured on customer accounts in scope                                                | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/syncs/conversion-actions.ts)                   |
| `keyword-criteria`                   | Sync ad group keyword criteria for customer accounts in scope                                                   | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/google-ads/syncs/keyword-criteria.ts)                     |

***
