📖 개념 정의 및 실무 적용

대형 구인구직 플랫폼이나 미디어 사이트에서는 매일 수천 개 이상의 페이지가 새로 생겨나고 사라집니다. 전통적인 사이트맵(Sitemap) 제출 방식은 구글 크롤러가 사이트를 다시 방문할 때까지 며칠에서 몇 주까지 소요되므로, 마감일이 촉박한 채용 공고나 실시간 속보가 적시에 노출되지 않는 치명적인 비효율이 발생합니다. 구글 색인 API를 도입하면 웹페이지가 퍼블리시되는 즉시 REST API를 통해 구글 검색엔진에 푸시(Push) 신호를 보낼 수 있어 검색 반영 누락과 지연 문제를 원천적으로 해결합니다.

💻 실무 활용 코드 스니펫 (PYTHON)

from google.oauth2 import service_account
from googleapiclient.discovery import build
import json

# 서비스 계정 키 파일 경로 설정
KEY_FILE_PATH = 'path/to/service_account_key.json'
SCOPES = ['https://www.googleapis.com/auth/indexing']

def request_indexing(url_to_update, action_type='URL_UPDATED'):
    try:
        credentials = service_account.Credentials.from_service_account_file(
            KEY_FILE_PATH, scopes=SCOPES
        )
        service = build('indexing', 'v3', credentials=credentials)
        
        body = {
            "url": url_to_update,
            "type": action_type
        }
        
        response = service.urlNotifications().publish(body=body).execute()
        print(f"Successfully requested {action_type} for: {url_to_update}")
        return response
    except Exception as e:
        print(f"Error requesting indexing for {url_to_update}: {str(e)}")
        return None

if __name__ == '__main__':
    # 실무 활용 예시: 신규 등록된 채용 공고 URL 즉시 색인 요청
    target_url = 'https://example.com/jobs/12345'
    request_indexing(target_url, 'URL_UPDATED')

⚡ 5분 만에 적용하는 실행 스텝

1. Google Cloud Console에서 프로젝트를 생성하고 ‘Indexing API’를 활성화합니다.
2. 서비스 계정(Service Account)을 생성하고 JSON 형태의 비공개 키를 안전하게 다운로드합니다.
3. Google Search Console(GSC) 설정에서 해당 서비스 계정의 이메일 주소를 ‘소유자(Owner)’ 권한으로 등록합니다.
4. CMS 또는 백엔드 서버(Python, Node.js 등)에 API 코드를 연동하여 컨텐츠 발행 시 자동으로 요청이 가도록 트리거를 설정합니다.

❓ 자주 묻는 질문 (FAQ)