Google Indexing API 설정 가이드

개요

이 가이드는 비개발자도 따라할 수 있도록, Google Cloud Platform(GCP)에서 Indexing API를 설정하는 전 과정을 아주 친절하게 설명합니다.

---

사전 준비

시작하기 전에 아래 항목을 확인해 주세요.

• Google 계정: 일반 Gmail 계정이면 충분합니다.
• 웹브라우저: 가급적 Chrome 브라우저 사용을 권장합니다.

---

Step 1. GCP 프로젝트 생성하기

1-1. GCP 콘솔 접속

아래 링크를 클릭하여 Google Cloud Console에 접속합니다.

👉 Google Cloud Console 바로가기

1-2. 새 프로젝트 만들기

1. 화면 상단 왼쪽, Google Cloud 로고 바로 오른쪽에 있는 Select a project 버튼을 클릭합니다.
2. 팝업 창이 뜨면, 오른쪽 상단의 New project 버튼(파란색 + 아이콘)을 클릭합니다.

1-3. 프로젝트 이름 입력

1. Project name 입력란에 google-indexing-example을 입력합니다.
2. Project ID는 자동으로 생성됩니다. (나중에 변경할 수 없으니 참고만 하세요.)
3. Parent resource는 기본값(No organization)으로 두면 됩니다.
4. 하단의 파란색 Create 버튼을 클릭합니다.

1-4. 프로젝트 생성 확인

몇 초 후, 화면 오른쪽 상단에 알림(종 모양 아이콘)이 나타납니다. Create Project: google-indexing-example이라는 메시지와 함께 Select Project 링크가 보이면, 클릭하여 방금 만든 프로젝트로 이동합니다.

프로젝트 대시보드에서 Project name: google-indexing-example이 표시되면 성공입니다!

---

Step 2. Indexing API 활성화하기

2-1. Indexing API 검색

1. 화면 상단 중앙의 검색창을 클릭합니다.
2. Indexing API를 입력합니다.
3. 검색 결과의 Marketplace 섹션에서 Web Search Indexing API 항목을 클릭합니다.

2-2. API 활성화 (Enable)

1. 상세 페이지에 도착하면, 파란색 Enable 버튼을 클릭합니다.

2-3. 활성화 확인

잠시 기다리면 Status: Enabled라고 표시됩니다. 이제 API를 사용할 준비가 되었습니다!

---

Step 3. 서비스 계정(Service Account) 만들기

3-1. 서비스 계정 생성 페이지 이동

메뉴(☰) → IAM & Admin → Service Accounts → 상단의 + Create service account를 클릭합니다.

3-2. 서비스 계정 정보 입력

1. Service account name에 indexing-bot을 입력합니다.
2. Email address가 자동으로 생성됩니다. 이 이메일은 나중에 사용하므로 꼭 복사해 두세요!
3. Create and continue 버튼을 클릭합니다.

3-3. 권한(Role) 부여

1. Select a role 드롭다운에서 Basic → Owner를 선택합니다.
2. 하단의 Done 버튼을 클릭합니다.

---

Step 4. JSON 키 생성하기

도구가 API 요청을 안전하게 인증하려면 비공개 JSON 키가 필요합니다.

1. 방금 만든 서비스 계정을 클릭하여 엽니다.
2. Keys 탭으로 이동합니다.
3. Add key → Create new key를 클릭합니다.
4. JSON이 선택된 상태로 Create를 누릅니다.

브라우저에서 즉시 인증서 파일이 다운로드됩니다.

파일은 다음과 유사한 형태입니다:

{
  "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. Search Console에 서비스 계정 추가하기

JSON 키를 다운로드했다면, 마지막 단계는 Search Console 속성에 해당 서비스 계정의 접근 권한을 부여하는 것입니다. 상세한 방법은 아래 가이드를 참고해 주세요.

👉 Google Search Console 설정 가이드 보기

---

최종 체크리스트