구글 자동 색인 요청 구축: 세팅부터 운영까지

검색 결과 반영을 빠르게 만들고 싶다면, 콘텐츠 발행/수정/삭제 시점에 Google Indexing API를 자동 호출하는 구조가 가장 실용적입니다.

이 글은 구글 자동 색인 요청 시스템을 처음 구축하는 사람 기준으로, 준비사항부터 구현/운영/장애대응까지 한 번에 정리합니다.

1. 자동 색인 요청이 필요한 이유

일반적인 크롤링은 검색엔진이 “언제” 방문할지 예측하기 어렵습니다.

자동 색인 요청을 붙이면 URL 변경 이벤트를 즉시 전달할 수 있어, 반영 속도를 개선하는 데 도움이 됩니다.

자동화 대상 이벤트:

1. 글 발행: URL_UPDATED
2. 글 수정: URL_UPDATED
3. 글 삭제: URL_DELETED

2. 전체 아키텍처

1. 에디터/관리 화면에서 발행·수정·삭제 이벤트 발생
2. 백엔드 내부 API로 색인 요청 트리거
3. 백엔드가 서비스 계정 JWT로 액세스 토큰 발급
4. Google Indexing API urlNotifications:publish 호출
5. 성공/실패 로그 기록 + 재시도 큐 처리(선택)

핵심 원칙:

1. 비밀키는 반드시 서버에서만 사용