Skip to main content
March 11, 202610 min

Google Indexing API Setup Guide

Follow a structured walkthrough to create your Google Cloud project, enable Indexing API, issue a JSON key, and connect Search Console ownership.

Overview

This guide explains the entire process of setting up the Indexing API on Google Cloud Platform (GCP) in a very friendly way so that even non-developers can follow along.


Prerequisites

Please check the items below before starting.

  • Google Account: A regular Gmail account is sufficient.
  • Web Browser: We recommend using the Chrome browser if possible.

Step 1. Creating a GCP Project

Understand by analogy

Think of a GCP project as a single working folder. All the API settings you want to do take place inside this folder.

1-1. Access the GCP Console

Click the link below to access the Google Cloud Console.

👉 Go to Google Cloud Console

GCP Console Welcome Page

1-2. Create a new project

  1. Click the Select a project button at the top left of the screen, just to the right of the Google Cloud logo.
  2. When the popup window appears, click the New project button (blue + icon) in the upper right corner.
Project Selection Popup

1-3. Enter project name

  1. Enter google-indexing-example in the Project name field.
  2. The Project ID is generated automatically. (Note that it cannot be changed later.)
  3. Parent resource can be left as the default (No organization).
  4. Click the blue Create button at the bottom.
Project name entry screen

1-4. Confirm project creation

After a few seconds, a notification (bell icon) appears in the upper right corner of the screen. When you see a message saying Create Project: google-indexing-example along with a Select Project link, click it to go to the project you just created.

Project creation completion notification

Success if Project name: google-indexing-example is displayed in the project dashboard!

Project Dashboard

Step 2. Activating the Indexing API

Understand by analogy

Activating an API is like installing an app from the App Store. You need to 'install' the Indexing API feature into your project to use it.

2-1. Search for Indexing API

  1. Click the search bar at the top center of the screen.
  2. Enter Indexing API.
  3. In the Marketplace section of the search results, click the Web Search Indexing API item.
Indexing API search results

Note: Be sure to click Web Search Indexing API in the Marketplace section below, not the "Top results" at the top.

2-2. Activate API (Enable)

  1. Once you arrive at the detail page, click the blue Enable button.
Enable Button

2-3. Confirm activation

Wait a moment and it will display Status: Enabled. The API is now ready for use!

API Activation Completed

Step 3. Creating a Service Account

Understand by analogy

A service account is a kind of robot assistant. It plays the role of sending requests to Google on your behalf, like "Please index this page!". This is the process of creating an ID for this assistant.

3-1. Go to the service account creation page

Click Menu (☰) → IAM & Admin → Service Accounts → + Create service account at the top.

Service account creation page

3-2. Enter service account information

  1. Enter indexing-bot for Service account name.
  2. An Email address is automatically generated. This email will be used later, so be sure to copy it!
  3. Click the Create and continue button.
Entering service account name

3-3. Grant Role (Permissions)

  1. Select Basic → Owner from the Select a role dropdown.
  2. Click the Done button at the bottom.
Select Owner role

Step 4. Generate the JSON key

The tool needs a private JSON key to authenticate API requests securely.

  1. Open the newly created service account.
  2. Switch to the Keys tab.
  3. Click Add key → Create new key.
  4. Keep JSON selected and press Create.
Service account details
Keys tab
Add key dropdown
Create JSON key dialog

Your browser will download the credential file immediately.

Created key list

Security warning

Never upload this JSON file to GitHub, a public drive, or a shared chat room. Anyone with the private key can act as your service account.

The file will look similar to this:

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "key-id",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
  "client_email": "indexing-bot@your-project-id.iam.gserviceaccount.com",
  "client_id": "client-id",
  "token_uri": "https://oauth2.googleapis.com/token"
}

Step 5. Add the service account in Search Console

Once you have downloaded the JSON key, the final step is to grant the service account access to your Search Console property. Please refer to the following guide for detailed instructions.

👉 View Google Search Console Setup Guide


Final checklist

StepItemStatus
Step 1Google Cloud project created✅
Step 2Web Search Indexing API enabled✅
Step 3Service account created and email copied✅
Step 4JSON key downloaded securely✅
Step 5Service account added in Search Console⬜

Checklist

  • A Google account that can access Google Cloud
  • Access to the target site in Google Search Console
  • Owner-level permission for the property you want to submit
  • A secure local folder for the JSON key file