# Google Service Accounts

SEO Utils uses Google Service Accounts for multiple tasks like submitting index, checking/submitting index for URLs, or pulling data from Google Search Console (GSC) to do some advanced tasks that the GSC dashboard doesn't provide to you.

### Create a Google Service Account

#### Step 1

Visit the Google Cloud Console at <https://console.cloud.google.com/> and create a Project if you don't have one.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-fed3ebd0e873d1eb361254ecf4c04de3847767f1%2FXnapper-2023-11-30-17.42.13.png?alt=media" alt=""><figcaption><p>Create a project on Google Cloud Console</p></figcaption></figure>

#### Step 2

In your [Google Cloud Console](https://console.cloud.google.com/) dashboard, search for "**Service Accounts**" and click on it.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-a1cc74a736cda2c0440b1e8b9ab41c553e091718%2FXnapper-2023-11-30-17.51.43.png?alt=media" alt=""><figcaption><p>Click on "Service Accounts" from the search results</p></figcaption></figure>

Hit the "**Create Service Account**" button, and enter a service account name. Then, hit the "**Done**" button.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-25f938df748c78cbfa2b6e28a69370b4d45db02f%2FXnapper-2023-11-30-17.56.52.png?alt=media" alt=""><figcaption><p>Enter service account name</p></figcaption></figure>

<mark style="color:green;">**Copy the email of the service account**</mark>. You will need that email to invite the service account to your Google Search Console so it can access data from Google Search Console.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-9785e7daf49d21a78bdaf7b770179cbb9c158ef6%2FXnapper-2023-11-30-17.58.38.png?alt=media" alt=""><figcaption><p>Copy the email</p></figcaption></figure>

#### Step 3: Create a Google Service Account key file

Click on the **Service Account's email,** select the "**KEYS**" tab, then click the "**Create new key**" button.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-4c8c4f49958bb72884c7a528d8baf1e336277a61%2FXnapper-2023-11-30-18.08.28.png?alt=media" alt=""><figcaption><p>Create a key for your service account</p></figcaption></figure>

A model will pop up. Select "JSON" and click the "Create" button.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-e7e6a767e843707a70f32c22e7d663f5ec465d19%2FXnapper-2023-11-30-18.10.57.png?alt=media" alt=""><figcaption><p>Select JSON in Key type field.</p></figcaption></figure>

After creating the key, Google will download it to your machine. Keep that file. You will need it when adding the Google Service Account to SEO Utils.

### Add the Google Service Account to SEO Utils

Open the SEO Utils app on your machine, and locate the App dropdown menu in the top-right corner. You will see the Google Service Accounts menu.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-32225513a998ac71511023f6547d93c854837cee%2FXnapper-2024-12-12-09.45.57.png?alt=media" alt="" width="375"><figcaption><p>Click on Google Service Accounts menu to create one</p></figcaption></figure>

Hit the "Add Account" button and select the key file you downloaded in the previous step.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-92590d2a67edf3384471354527570471f1946048%2FXnapper-2025-08-28-11.54.47.png?alt=media" alt=""><figcaption><p>Select the downloaded key file after cliking the "Add Account" button</p></figcaption></figure>

Congratulations! You have successfully added a Google Service Account to SEO Utils!

### Connect to Google Search Console

After adding the service account to SEO Utils, you need to grant it access to your Google Search Console properties to pull performance data and submit indexes.

#### Grant Access in Google Search Console

1. **Copy the Service Account Email**: After adding the JSON file, you'll see the service account email displayed (e.g., `seoutils-237@gpapp-1312935720840.iam.gserviceaccount.com`)

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-fedbeaffb5c8a2b01c6a9f11e173ce2f0290bef5%2FXnapper-2025-08-28-11.55.17.png?alt=media" alt=""><figcaption><p>Copy the Google Service Account email</p></figcaption></figure>

2. **Add to Google Search Console**:

* Go to your [Google Search Console Dashboard](https://search.google.com/search-console)
* Select your property
* Navigate to Settings → Users and permissions
* Click "Add user"
* Paste the service account email
* Select permission level:
  * **Owner**: Required for submitting indexes via Google Indexing API
  * **Full**: Sufficient for pulling performance data only

{% hint style="warning" %}
**Important**: To submit indexes, the service account must have **Owner** permission in Google Search Console. Full permission is only adequate for reading performance data.
{% endhint %}

### Configure Properties for Index Submission

You can configure which properties each service account can submit indexes for. This setting only affects index submission, not performance data access.

#### Property Configuration Options

**All Properties (Default)**

* When enabled, the service account can submit indexes for all properties in your SEO Utils account
* This is the default setting for new service accounts

**Specific Properties**

* When disabled, you can select specific properties that this service account can access
* Toggle off "All Properties" to reveal a list of available properties
* Check the properties you want this service account to submit indexes for

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-7e6c5e015b3b2f078634a1c19e012ecee4fd4b62%2FXnapper-2025-08-28-11.58.33.png?alt=media" alt=""><figcaption><p>Select specific properties for this service account to access</p></figcaption></figure>

{% hint style="info" %}
**Note**: This property configuration is for index submission only. The service account can still pull performance data from all properties where it has been granted access in Google Search Console.
{% endhint %}
