/  가이드  /  워드프레스

구글 Indexing API 연결하기 — 색인 속도를 앞당기는 설정
워드프레스

구글 Indexing API 연결하기 — 색인 속도를 앞당기는 설정

ES에코스튜디오 2024년 3월 4일

글을 발행해도 구글에 반영되기까지는 며칠에서 몇 주가 걸립니다. Indexing API를 연결하면 새 글을 올리는 즉시 구글에 알릴 수 있어, 색인 속도가 크게 빨라집니다.

설정은 한 번만 하면 되고, 이후로는 자동으로 동작합니다. 다만 구글 클라우드 콘솔을 처음 쓰시면 화면이 낯설 수 있어 단계별로 정리했습니다.

먼저 알아두실 것 — 공식 지원 범위

구글 공식 문서에는 Indexing API를 채용 공고(JobPosting)라이브 스트리밍 영상(BroadcastEvent) 페이지에만 쓰도록 적혀 있습니다. 일반 블로그 글은 문서상 지원 대상이 아닙니다.

그럼에도 많은 사이트가 일반 글에 쓰고 있고, 색인이 빨라졌다는 사례도 계속 보고됩니다. 다만 구글이 언제든 무시하거나 막을 수 있는 방식이라는 점은 알고 시작하시는 게 맞습니다. 이 글은 그 전제 위에서 설정 방법을 정리한 것입니다.

이 설정으로 얻는 것

  • 새 글·수정한 글을 발행 즉시 구글에 알림 (반영을 보장하지는 않습니다)
  • 색인 요청을 수동으로 하나씩 넣을 필요가 없어짐
  • 서치콘솔의 “URL 검사 → 색인 요청” 반복 작업 불필요
1

구글 클라우드에서 프로젝트를 만듭니다

console.cloud.google.com에 접속합니다. 워드프레스와 서치콘솔에 사용 중인 같은 구글 계정으로 로그인하세요.

로그인하면 상단 파란 막대에 프로젝트 선택 드롭다운이 있습니다. 이것을 누르고 오른쪽 위 새 프로젝트를 선택합니다.

프로젝트 이름 입력
프로젝트 이름은 Indexing API처럼 알아보기 쉽게 지어주세요
2

서비스 계정을 생성합니다

왼쪽 위 (햄버거) 메뉴를 누르고 IAM 및 관리자 → 서비스 계정으로 들어갑니다. 서비스 계정은 사람이 아니라 프로그램이 쓰는 계정이라고 생각하시면 됩니다. 워드프레스가 이 계정의 자격으로 구글에 요청을 보내게 됩니다.

메뉴를 못 찾겠다면

화면 위 검색창에 서비스 계정이라고 입력하면 바로 이동할 수 있습니다. 구글 클라우드 콘솔은 메뉴가 깊어서 검색이 훨씬 빠릅니다.

서비스 계정 만들기
“서비스 계정 만들기”를 클릭합니다
서비스 계정 정보 입력
이름을 입력하고 생성합니다. 역할은 지정하지 않아도 됩니다
생성된 서비스 계정 목록
생성된 계정의 이메일 주소를 복사해 두세요. 4단계에서 사용합니다
3

인증 키(JSON)를 내려받습니다

서비스 계정을 클릭한 뒤 탭에서 새 키를 만듭니다. 형식은 반드시 JSON을 선택하세요.

키 탭에서 새 키 만들기
키 → 키 추가 → 새 키 만들기
JSON 키 형식 선택
JSON을 선택하면 파일이 자동으로 다운로드됩니다
이 JSON 파일은 비밀번호와 같습니다

파일 안에 계정 접근 권한이 그대로 들어 있습니다. 블로그에 업로드하거나 다른 사람에게 공유하지 마시고, 안전한 곳에 보관하세요. 유출되었다면 콘솔에서 해당 키를 삭제하고 새로 발급하시면 됩니다.

4

Indexing API를 사용 설정합니다

API 라이브러리에서 Indexing API를 검색해 사용 설정합니다. 이 단계를 건너뛰면 키가 있어도 동작하지 않습니다.

API 라이브러리 검색
API 및 서비스 → 라이브러리에서 Indexing API 검색
Indexing API 사용 설정
“사용” 버튼을 눌러 활성화합니다
5

서치콘솔에 소유자로 추가합니다

마지막 단계입니다. 2단계에서 복사해 둔 서비스 계정 이메일을 구글 서치콘솔의 소유자로 추가해야 합니다. 권한을 ‘전체’가 아니라 소유자로 지정해야 API가 동작합니다.

서치콘솔 설정 화면
서치콘솔 → 설정 → 사용자 및 권한
사용자 추가
서비스 계정 이메일을 입력하고 권한을 소유자로 지정합니다
설정 완료
이제 워드프레스 플러그인에 JSON 키를 등록하면 연동이 끝납니다
‘소유자’가 아니면 동작하지 않습니다

서치콘솔에서 권한을 전체로 주면 안 됩니다. 반드시 소유자여야 합니다. 이 단계에서 막히는 경우가 가장 많습니다.

서치콘솔 속성이 도메인 속성인지 URL 접두어 속성인지도 확인하세요. 두 개를 모두 등록해두셨다면 양쪽 다 소유자로 추가하는 편이 안전합니다.

설정이 끝났는지 확인하는 법

워드프레스에서 Rank Math의 Instant Indexing 같은 플러그인에 JSON 키를 등록하고 글을 하나 발행해 보세요. 정상이라면 플러그인 로그에 200 OK 응답이 남습니다.

자주 나오는 오류

  • Permission denied — 서비스 계정이 서치콘솔 소유자로 등록되지 않았습니다(5단계 확인)
  • API not enabled — Indexing API 사용 설정을 건너뛰었습니다(4단계 확인)
  • Invalid credentials — JSON 키를 잘못 붙여 넣었습니다. 파일 전체 내용을 그대로 넣어야 합니다

이것만으로는 순위가 오르지 않습니다

Indexing API가 하는 일은 “새 글이 생겼으니 와서 보라”고 알리는 것까지입니다. 색인에 들어가는 속도를 앞당길 뿐, 순위를 올려주지는 않습니다. 내용이 부실하면 빨리 색인되고 빨리 묻힐 뿐입니다.

색인 속도를 높이는 방법은 이것 말고도 있습니다. 함께 해두시면 좋습니다.

방법 효과
사이트맵 제출 가장 기본입니다. 서치콘솔에 sitemap_index.xml을 한 번만 등록해두면 됩니다.
URL 검사 → 색인 요청 서치콘솔에서 글 주소를 직접 넣습니다. 하루 몇 개 정도로 제한되지만 확실합니다.
IndexNow 빙·네이버가 지원하는 방식입니다. 구글은 참여하지 않지만, 국내 유입을 생각하면 걸어둘 가치가 있습니다.
내부 링크 새 글을 기존 글에서 링크해주면 크롤러가 훨씬 빨리 찾아옵니다. 가장 저평가된 방법입니다.

설정이 복잡하게 느껴지시면 카카오톡으로 문의해 주세요. 색인 API 연결은 저희 블로그 제작애드센스 대행 서비스에 포함되어 있습니다.

자주 나오는 질문

이걸 걸면 모든 글이 바로 색인되나요

아닙니다. “새 글이 올라왔다”는 신호가 빨리 전달될 뿐이고, 색인할지 말지는 구글이 판단합니다. 내용이 얇으면 요청을 보내도 색인되지 않습니다.

네이버에도 같은 방법을 쓸 수 있나요

구글 Indexing API는 구글 전용입니다. 네이버와 빙은 IndexNow라는 다른 방식을 지원합니다. 구글은 IndexNow에 참여하지 않지만, 국내 유입을 생각하면 둘 다 걸어둘 가치가 있습니다.

설정이 복잡한데 꼭 해야 하나요

필수는 아닙니다. 색인을 앞당기는 방법 중 가장 저평가된 것은 내부 링크입니다. 새 글을 기존 글에서 링크해 주면 크롤러가 훨씬 빨리 찾아옵니다. 이것부터 해보시고 그래도 느리면 API를 검토하세요.

이어서 읽어보세요

카카오톡 상담 문의 남기기 주문서 작성 맨 위로