Google Indexing API 설정 완벽 가이드: 초보자도 따라 할 수 있는 단계별 과정
웹사이트 운영자라면 누구나 한 번쯤 경험해봤을 것입니다. 새로운 페이지를 게시했는데 Google 검색결과에 나타나는 데 며칠이 걸리는 답답한 상황 말이죠. 특히 시간에 민감한 콘텐츠(채용정보, 이벤트, 뉴스 등)를 다루는 웹사이트라면 더욱 그렇습니다. 이런 문제를 해결하기 위해 Google이 제공하는 강력한 도구가 바로 Indexing API입니다.
목차
Indexing API를 설정하면 새로운 페이지나 수정된 페이지를 Google에 직접 알릴 수 있으며, 이를 통해 검색 색인 속도를 획기적으로 단축할 수 있습니다. 이 글에서는 API 설정부터 실제 사용까지 모든 과정을 단계별로 설명하겠습니다.
Google Indexing API란?
Indexing API는 웹사이트 소유자가 새로운 페이지 추가, 기존 페이지 수정, 또는 페이지 삭제를 Google에 직접 알릴 수 있는 도구입니다. 기존의 방식처럼 Google 검색 봇이 자연스럽게 웹사이트를 크롤링하기를 기다리는 대신, 주도적으로 Google에 변화를 알려 빠르게 검색 색인에 반영되도록 합니다.
주요 특징:
- 새 URL이나 수정된 URL을 분 단위로 색인 처리 가능
- 삭제된 URL을 검색결과에서 신속하게 제거
- 매일 최대 200개의 URL 제출 가능 (기본 할당량)
- 하루에 제출 한도를 초과하면 할당량 증설 신청 가능
API 설정 전 필수 요건
Google Indexing API를 사용하기 위해서는 먼저 다음 조건들을 충족해야 합니다:
- Google 계정 소유
- Google Search Console에서 웹사이트 소유권 인증 완료
- Google Cloud 프로젝트 생성 권한
- 기본적인 API 개념 이해 (HTTP, JSON)
특히 Search Console에서 웹사이트 소유권을 인증받는 것은 필수입니다. 아직 Search Console에 등록하지 않았다면 먼저 Google Search Console에 접속하여 웹사이트를 등록하고 소유권을 인증하세요.
단계별 API 설정 가이드
1단계: Google Cloud Console에서 프로젝트 생성
가장 먼저 할 일은 Google Cloud Console에서 새로운 프로젝트를 만드는 것입니다.
- Google Cloud Console(https://console.cloud.google.com)에 접속합니다.
- 상단의 “프로젝트 선택” 드롭다운을 클릭합니다.
- “새 프로젝트” 버튼을 클릭하고 프로젝트 이름을 입력합니다. (예: “MyWebsite-Indexing”)
- “만들기” 버튼을 클릭하면 프로젝트가 생성됩니다. (1-2분 소요)
💡 팁: 여러 웹사이트를 관리한다면 각 사이트별로 별도의 프로젝트를 만드는 것이 좋습니다.
[이미지 삽입 포인트 1: Google Cloud Console 프로젝트 생성 화면]
2단계: Indexing API 활성화
이제 프로젝트에서 Indexing API를 활성화해야 합니다.
- 생성한 프로젝트가 자동으로 선택되지 않았다면 상단의 프로젝트 선택 드롭다운에서 방금 생성한 프로젝트를 선택합니다.
- 좌측 사이드바에서 “API 및 서비스” → “라이브러리”를 클릭합니다.
- 검색창에 “Indexing API”를 입력합니다.
- 검색 결과에서 “Web Search Indexing API”를 선택합니다.
- “활성화” 버튼을 클릭하면 API가 활성화됩니다.
마찬가지로 “Google Search Console API”도 활성화하는 것이 좋습니다. 같은 방식으로 라이브러리에서 검색하여 활성화하세요.
3단계: 서비스 계정 생성 및 키 생성
Google API는 OAuth 인증을 필요로 합니다. 서비스 계정은 웹사이트에서 API를 호출할 때 사용할 “로봇 계정”이라고 생각하면 됩니다.
- Google Cloud Console에서 “IAM 및 관리자” → “서비스 계정”을 클릭합니다.
- “서비스 계정 만들기”를 클릭합니다.
- 서비스 계정의 이름을 입력합니다. (예: “indexing-api-bot”)
- “만들고 계속하기”를 클릭합니다.
- 역할 선택 단계에서 “소유자” 역할을 선택합니다.
- “계속”을 클릭한 후 “완료”를 클릭합니다.
이제 서비스 계정이 생성되었습니다. 다음은 이 계정의 JSON 키를 생성해야 합니다.
- 생성된 서비스 계정 목록에서 방금 만든 계정을 클릭합니다.
- “키” 탭을 선택합니다.
- “키 추가” → “새 키 만들기”를 클릭합니다.
- 키 타입으로 “JSON”을 선택합니다.
- “만들기”를 클릭하면 JSON 파일이 자동으로 다운로드됩니다.
⚠️ 주의사항: 다운로드한 JSON 파일에는 API 인증에 필요한 민감한 정보가 포함되어 있습니다. 절대로 공개 저장소(GitHub 등)에 업로드하지 마세요. 안전한 장소에 보관하세요.
4단계: Google Search Console에 서비스 계정 추가
Indexing API가 실제로 작동하려면 Google Search Console에서 권한을 부여해야 합니다. 이제 서비스 계정의 이메일 주소를 복사해서 Search Console에 소유자로 추가합니다.
- Google Cloud Console의 서비스 계정 목록에서 생성한 계정을 클릭합니다.
- 이메일 주소를 복사합니다. (예: indexing-api-bot@project-12345.iam.gserviceaccount.com)
- Google Search Console(https://search.google.com/search-console)에 접속합니다.
- Indexing API를 적용할 웹사이트 속성을 선택합니다.
- “설정” → “사용자 및 권한”을 클릭합니다.
- “사용자 추가”를 클릭하고 복사한 서비스 계정 이메일을 붙여넣기합니다.
- 권한을 “소유자”로 설정하고 “추가”를 클릭합니다.
이 단계가 완료되면 서비스 계정은 Search Console에서 해당 웹사이트에 대한 모든 권한을 갖게 됩니다.
API를 통한 URL 색인 제출 방법
HTTP POST 요청 구조
Indexing API를 사용하려면 다음 엔드포인트로 HTTP POST 요청을 보내야 합니다:
https://indexing.googleapis.com/v3/urlNotifications:publish요청 본문은 다음과 같은 JSON 형식이어야 합니다:
{
"url": "https://example.com/new-page",
"type": "URL_UPDATED"
}여기서 “type” 필드는 두 가지 값만 허용됩니다:
- URL_UPDATED: 새 페이지가 추가되거나 기존 페이지가 수정되었을 때
- URL_DELETED: 페이지가 삭제되었을 때
Python 예제 코드
실제 구현 예제를 보여드리겠습니다. Python을 사용하여 URL을 색인하는 방법입니다:
import requests
import json
from google.oauth2 import service_account
# 1. 서비스 계정 JSON 파일로부터 인증정보 로드
credentials = service_account.Credentials.from_service_account_file(
"path/to/service_account.json",
scopes=["https://www.googleapis.com/auth/indexing"]
)
# 2. API 엔드포인트 및 헤더 설정
ENDPOINT = "https://indexing.googleapis.com/v3/urlNotifications:publish"
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {credentials.token}"
}
# 3. 색인할 URL과 타입 지정
data = json.dumps({
"url": "https://yourwebsite.com/new-page",
"type": "URL_UPDATED"
})
# 4. API에 요청 보내기
response = requests.post(ENDPOINT, headers=headers, data=data)
# 5. 응답 확인
if response.status_code == 200:
print("✓ URL 색인 요청 성공!")
else:
print(f"✗ 오류: {response.status_code}")
print(response.text)이 스크립트를 실행하면 Google에 URL 색인을 요청하는 HTTP POST 요청이 전송됩니다.
[이미지 삽입 포인트 6: 코드 예제 설명 다이어그램]
할당량 및 제한사항
Google Indexing API를 사용할 때는 다음과 같은 제한사항이 있습니다:
| 항목 | 제한 |
|---|---|
| 일일 제출 URL 수 | 기본 200개 (할당량 증설 가능) |
| 한 번에 제출 가능한 URL 수 | 최대 100개 (배치 요청) |
| 요청 크기 | 1MB 이하 |
| API 호출 응답 시간 | 보통 1-2초 |
만약 하루에 200개보다 많은 URL을 제출해야 한다면, Google Cloud Console에서 할당량 증설을 신청할 수 있습니다.
자주하는 질문(FAQ)
Q1. API를 설정하면 바로 Google 검색결과에 나타나나요?
A: 아닙니다. API로 URL을 제출하면 Google은 우선순위를 높여 해당 페이지를 크롤링하고 색인하게 되지만, 검색결과에 나타나는 시간은 콘텐츠의 품질, 페이지 권위도, 검색 의도 일치도 등 다양한 요인에 따라 결정됩니다. 일반적으로 수 분에서 수 시간 이내에 크롤링이 이루어집니다.
Q2. 일반 블로그나 뉴스 사이트에도 API를 사용할 수 있나요?
A: 원래 Indexing API는 채용정보와 라이브 스트리밍 이벤트 페이지를 위해 설계되었습니다. 하지만 실제로는 많은 웹사이트와 SEO 전문가들이 블로그, 뉴스, e-커머스 사이트 등 다양한 콘텐츠에 사용하고 있습니다.
Q3. 비용이 드나요?
A: 기본적으로 Indexing API는 무료입니다. 일일 200개 URL 제출 제한이 있지만, 추가 할당량이 필요하면 Google Cloud 가격 모델에 따라 비용이 발생할 수 있습니다.
Q4. 이미 Google Search Console에서 URL을 제출했는데도 API를 써야 하나요?
A: 네, 필요합니다. Search Console의 URL 제출 기능은 하루에 최대 10-20개 정도만 처리할 수 있지만, Indexing API는 200개까지 처리할 수 있습니다. 특히 대량의 콘텐츠를 생성하는 웹사이트라면 API 사용이 훨씬 효율적입니다.
설정 후 점검 체크리스트
API 설정을 완료했다면 다음 사항들을 확인하세요:
- ☑ Google Cloud Console에서 Indexing API가 활성화되어 있는가?
- ☑ 서비스 계정이 JSON 키와 함께 생성되었는가?
- ☑ Google Search Console에 서비스 계정이 소유자로 추가되었는가?
- ☑ 다운로드한 JSON 파일이 안전한 위치에 보관되어 있는가?
- ☑ API 요청 테스트가 HTTP 200 응답을 반환하는가?
- ☑ Google Cloud Console 대시보드에서 API 호출 통계가 나타나는가?
결론
Google Indexing API는 웹사이트의 검색 가시성을 크게 향상시킬 수 있는 강력한 도구입니다. 초기 설정이 조금 복잡할 수 있지만, 일단 설정하면 프로그래밍을 통해 자동으로 URL 색인을 관리할 수 있습니다.
특히 뉴스 사이트, 채용정보 사이트, 블로그, e-커머스 플랫폼 등 자주 업데이트되는 콘텐츠를 다루는 웹사이트라면 이 API 설정은 필수적입니다. 이 글을 따라 설정하면서 어려운 부분이 있다면, 각 단계별로 제시된 공식 Google 문서를 참고하시기 바랍니다.
지금 바로 Google Indexing API를 설정하고 검색 색인 속도를 향상시켜보세요!
Related Posts
