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

# Connect Google Ads with Service Account – StackOne Hub

> Link a Google Ads account in the StackOne Hub using Service Account. End-user guide to authorize the integration and start using Google Ads actions.

> [!WARNING]
>
> You need permission to create service accounts, grant roles and create keys in the Google Cloud project, such as the Service Account Admin, Service Account Key Admin and Project IAM Admin roles. You also need administrative access to the Google Ads account to add the service account as a user, and a developer token from a manager account's API Center.

## Creating a service account key

The service account is created in a Google Cloud project, then added as a user in Google Ads. Google Ads access is granted in Google Ads, not in Google Cloud IAM.

**1. Enable the required APIs**

Sign in to the [Google Cloud Console](https://console.cloud.google.com/) and select the project. Turn on the Google Ads API.

<ul>
  <li>For each API, search for it in **Search (/) for resources, docs, products, and more** and open it.</li>
  <li>Click **Enable**.</li>
  <li>If the page shows **Manage** and **API Enabled**, the API is already on.</li>
</ul>

**2. Create the service account**

Open **IAM & Admin** > **Service Accounts**.

<ul>
  <li>Click **Create service account**.</li>
  <li>**Service account name**: `StackOne Integration`</li>
  <li>Click **Create and continue**.</li>
</ul>

![Create service account form with the Service account name field and the Create and continue button highlighted.](https://mintcdn.com/stackone-60/pMIP-vOSCXF_XTCE/connectors/googleads/images/service-account-config-create-account.png?fit=max\&auto=format\&n=pMIP-vOSCXF_XTCE\&q=85\&s=1fdb9ccfc43aea0d7f79f01692462ea2)

**3. Create the JSON key**

In **Service Accounts**, click the email of the new service account and open the **Keys** tab.

<ul>
  <li>Click **Add key**.</li>
  <li>Select **Create new key**.</li>
  <li>**Key type**: **JSON**</li>
  <li>Click **Create**. The key file downloads once, and Google can't recover it if it is lost.</li>
  <li>If your organization blocks key creation with an organization policy, ask an organization policy administrator to allow it for this project.</li>
</ul>

![Create private key dialog with the JSON key type and the Create button highlighted.](https://mintcdn.com/stackone-60/pMIP-vOSCXF_XTCE/connectors/googleads/images/service-account-config-create-key.png?fit=max\&auto=format\&n=pMIP-vOSCXF_XTCE\&q=85\&s=b6e24b2517cbdddb1fbb37bbf5e9ac15)

## Granting the service account access in Google Ads

The service account reaches nothing until it is added as a user on each Google Ads account this connection should reach.

<ul>
  <li>Sign in to [Google Ads](https://ads.google.com/) as an administrator of the account.</li>
  <li>Click **Admin**, then **Access and security**, then the **Users** tab.</li>
  <li>Click **+**, the plus button, to invite a user.</li>
  <li>Enter the service account's email address, which ends in `iam.gserviceaccount.com` and is the `client_email` value in the key file.</li>
  <li>Select an access level. **Email only** is not supported for service accounts, and administrative access can't be granted to one.</li>
  <li>Click **Send invitation**.</li>
  <li>One service account email can be associated with up to 20 Google Ads accounts. Use a manager account above that.</li>
</ul>

## Entering the key

Open the downloaded `.json` key file in a text editor. The whole file, including the outer braces, is the key.

<ul>
  <li>Copy the **Service Account Key (JSON)** across.</li>
  <li>If the connection reaches client accounts through a manager account, copy that manager account's 10-digit ID, without hyphens, across to **Login Customer ID**.</li>
</ul>

## Link the Account

**1. Connect**

<ul>
  <li>Click **Connect**.</li>
  <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
  <li>Once authorization is successful, you will see a confirmation popup.</li>
</ul>

**2. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.