🚀 Google Indexing API 설정 최단 경로 가이드

구글 Indexing API를 사용하기 위해 필요한 Service Account Key를 발급받고 Search Console에 연결하는 과정입니다. 이 과정은 단 한 번만 진행하면 됩니다.

---

1단계: 프로젝트 생성 및 API 사용 설정

1. 구글 클라우드 콘솔에 접속하여 로그인합니다.
2. 상단에서 [새 프로젝트]를 생성하고 해당 프로젝트를 선택합니다.
3. 상단 검색창에 Indexing API를 검색합니다.
4. 검색 결과에서 [Indexing API]를 클릭하고 [사용(ENABLE)] 버튼을 누릅니다.

---

2단계: 서비스 계정 생성 및 JSON 키 발급

봇에게 사이트 관리 권한을 주기 위한 ‘신분증’을 만드는 과정입니다.

1. 왼쪽 메뉴 버튼(≡) > [IAM 및 관리자] > [서비스 계정]으로 이동합니다.
2. 상단 [+ 서비스 계정 만들기]를 클릭합니다.
3. 이름을 입력합니다 (예: index-bot).
4. 나머지 단계(권한 설정)는 건너뛰고 [완료]를 클릭합니다.
5. 생성된 서비스 계정 리스트에서 해당 계정의 이메일 주소를 복사합니다. (4단계에서 사용)
6. 해당 계정의 상세 페이지로 들어가 상단 [키 (KEYS)] 탭을 클릭합니다.
7. [키 추가] > [새 키 만들기]를 클릭합니다.
8. 키 유형에서 [JSON]을 선택하고 [만들기]를 누릅니다.
9. service_account.json 파일이 자동으로 다운로드됩니다. (이 파일이 코드에 필요한 키 파일입니다.)

---

3단계: 구글 서치 콘솔에 ‘봇’ 초대하기 (필수)

API가 작동하려면 이 계정이 사이트의 관리자 권한을 가지고 있어야 합니다.

1. 구글 서치 콘솔에 접속합니다.
2. 왼쪽 메뉴 하단 [설정]을 클릭합니다.
3. [사용자 및 권한] 클릭 > [사용자 추가] 버튼을 클릭합니다.
4. 이메일 주소: 2단계-5번에서 복사해둔 서비스 계정 이메일을 붙여넣습니다.
5. 권한: 반드시 [소유자(Owner)]로 설정합니다.
6. [추가]를 클릭합니다.

---

최종 확인

1. 다운로드 받은 service_account.json 파일이 Python 스크립트와 같은 경로에 있는지 확인합니다.
2. Service Account가 Search Console의 소유자로 등록되었는지 확인합니다.