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-developerscan 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
1-2. Create a new project
- Click the
Select a projectbutton at thetop leftof the screen, just to the right of the Google Cloud logo. - When the popup window appears, click the
New projectbutton (blue + icon) in the upper right corner.
1-3. Enter project name
- Enter
google-indexing-examplein theProject namefield. - The
Project IDis generated automatically. (Note that it cannot be changed later.) Parent resourcecan be left as the default (No organization).- Click the blue
Createbutton at the bottom.
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.
Success if Project name: google-indexing-example is displayed in the 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
- Click the search bar at the
top centerof the screen. - Enter
Indexing API. - In the
Marketplacesection of the search results, click theWeb Search Indexing APIitem.
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)
- Once you arrive at the detail page, click the blue
Enablebutton.
2-3. Confirm activation
Wait a moment and it will display Status: Enabled. The API is now ready for use!
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.
3-2. Enter service account information
- Enter
indexing-botforService account name. - An
Email addressis automatically generated. This email will be used later, sobe sure to copy it! - Click the
Create and continuebutton.
3-3. Grant Role (Permissions)
- Select
Basic→Ownerfrom theSelect a roledropdown. - Click the
Donebutton at the bottom.
Step 4. Generate the JSON key
The tool needs a private JSON key to authenticate API requests securely.
- Open the newly created service account.
- Switch to the
Keystab. - Click
Add key → Create new key. - Keep
JSONselected and pressCreate.
Your browser will download the credential file immediately.
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
| Step | Item | Status |
|---|---|---|
| Step 1 | Google Cloud project created | ✅ |
| Step 2 | Web Search Indexing API enabled | ✅ |
| Step 3 | Service account created and email copied | ✅ |
| Step 4 | JSON key downloaded securely | ✅ |
| Step 5 | Service 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