웹사이트에 새 글이나 상품 페이지를 게시한 뒤 구글 검색 결과에 뜰 때까지 며칠씩 기다려본 경험이 있을 것이다.
다만 구글 서치 콘솔에서 수동으로 URL 검사를 돌리고 색인 생성 요청을 클릭하거나, 크롤러가 오기만을 무작정 기다리는 개발자가 많다.
이번에는 Google Indexing API가 정확히 무엇인지, 왜 필요한지, PHP cURL 환경에서 인증 과정을 거쳐 자동 색인 요청을 구현하는 방법까지 완벽하게 정리해서 소개하겠다.
새로운 페이지를 서버에 배포하더라도 구글 크롤러(Googlebot)가 즉시 해당 URL을 방문하지는 않는다. 웹사이트의 전체 규모와 크롤링 예산에 따라 수집 주기가 결정되기 때문이다. 이로 인해 며칠에서 심하게는 몇 주 이상 색인 생성이 지연되어 검색 노출 타이밍을 놓치기도 한다.
Google Indexing API는 웹서버가 구글 알림 서버로 엔드포인트 HTTP 요청을 보내 URL 추가 및 업데이트 소식을 직접 알리는 REST API다. 이 API로 요청을 전달하면 구글 색인 시스템 내부 작업 큐에 해당 URL이 즉시 등록되어 크롤러가 우선순위를 두고 방문하게 된다.
API를 호출하려면 Google Cloud 콘솔에서 서비스 계정을 만들고, 생성된 이메일에 서치 콘솔 권한을 부여해야 한다.
1. Google Cloud Console에 접속한 뒤 새 프로젝트를 만들고 'Indexing API'를 검색해 활성화한다.
2. [IAM 및 행정관리] > [서비스 계정] 메뉴에서 새 서비스 계정을 생성한다.
3. 생성된 서비스 계정의 [키] 탭에서 JSON 형식의 새 키를 발급받아 서버의 안전한 경로에 저장한다.
4. Google Search Console로 이동해 해당 서비스 계정 이메일(예: example@project.iam.gserviceaccount.com)을 사용자 및 권한 관리에서 '소유자(Owner)' 권한으로 등록한다.
서비스 계정 키 파일(JSON)의 인증 정보를 활용해 JWT(JSON Web Token)를 생성한 후, OAuth 2.0 액세스 토큰을 받아 구글 엔드포인트로 색인 요청을 전송하는 실무 코드다.
✗ 잘못된 코드 (인증 토큰 없이 요청을 보내거나 일반 API 키로 접근하는 경우)
<?php
// 인증 헤더 없이 직접 호출 시 401 Unauthorized 오류 발생
$ch = curl_init('https://indexing.googleapis.com/v3/urlNotifications:publish');
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
'url' => 'https://example.com/blog/new-post',
'type' => 'URL_UPDATED'
]));
$response = curl_exec($ch);
// 실행 결과: HTTP Status 401 (Unauthenticated)
✓ 올바른 코드 (JSON 키 기반 JWT 발급 후 Bearer 토큰으로 Indexing API 호출)
<?php
function sendGoogleIndexingRequest($targetUrl, $jsonKeyPath) {
if (!file_exists($jsonKeyPath)) {
return false;
}
$keyData = json_decode(file_get_contents($jsonKeyPath), true);
$now = time();
// 1. JWT Header 및 Payload 구성
$header = rtrim(strtr(base64_encode(json_encode(['alg' => 'RS256', 'typ' => 'JWT'])), '+/', '-_'), '=');
$payload = rtrim(strtr(base64_encode(json_encode([
'iss' => $keyData['client_email'],
'scope' => 'https://www.googleapis.com/auth/indexing',
'aud' => 'https://oauth2.googleapis.com/token',
'exp' => $now + 3600,
'iat' => $now
])), '+/', '-_'), '=');
// 2. 비공개키 서명 생성
$signatureInput = $header . '.' . $payload;
openssl_sign($signatureInput, $rawSignature, $keyData['private_key'], 'SHA256');
$signature = rtrim(strtr(base64_encode($rawSignature), '+/', '-_'), '=');
$jwt = $signatureInput . '.' . $signature;
// 3. OAuth 2.0 Access Token 발급 요청
$tokenCh = curl_init('https://oauth2.googleapis.com/token');
curl_setopt($tokenCh, CURLOPT_RETURNTRANSFER, true);
curl_setopt($tokenCh, CURLOPT_POST, true);
curl_setopt($tokenCh, CURLOPT_POSTFIELDS, http_build_query([
'grant_type' => 'urn:ietf:params:oauth:grant-type:jwt-bearer',
'assertion' => $jwt
]));
$tokenRes = json_decode(curl_exec($tokenCh), true);
curl_close($tokenCh);
$accessToken = $tokenRes['access_token'] ?? null;
if (!$accessToken) {
return false;
}
// 4. Indexing API 색인 요청 전송
$ch = curl_init('https://indexing.googleapis.com/v3/urlNotifications:publish');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer ' . $accessToken
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
'url' => $targetUrl,
'type' => 'URL_UPDATED'
]));
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
return $httpCode === 200;
}
// 사용 예시
$result = sendGoogleIndexingRequest('https://example.com/blog/new-post', '/path/to/service-account.json');
var_dump($result);
// 실행 결과: bool(true)
구글 서치 콘솔 웹 UI를 통한 제출과 API 자동 제출 방식의 차이점을 표로 정리했다.
| 구분 | 서치 콘솔 수동 요청 | Google Indexing API |
|---|---|---|
| 작업 주체 | 관리자가 직접 브라우저에서 작업 | 백엔드 서버에서 자동 호출 |
| 처리 속도 | 대기 시간 불규칙 (수시간~수일) | 우선순위 큐 등록으로 빠른 반영 |
| 대량 처리 | 하루 몇 건으로 극히 제한적 | 기본 일 200건 할당 (증액 신청 가능) |
| 적용 시점 | 글 작성 후 별도 관리 시점 | DB Insert/Update 이벤트 시점 |
✗ 서비스 계정을 Google Search Console에 '일반 사용자'나 '수정자' 권한으로 등록하면 403 Permission Denied 에러가 발생한다.
✓ 서비스 계정 이메일은 반드시 서치 콘솔의 사용자 및 권한 메뉴에서 '소유자(Owner)' 권한으로 지정해야 API 통신이 성공한다.
✗ 게시물이 수정될 때마다 루프를 돌며 동일 URL로 API를 무분별하게 과도 호출하면 429 Too Many Requests 에러가 발생한다.
✓ 글 작성 및 최종 수정 완료 시점에 1회만 호출되도록 백그라운드 큐 시스템이나 디바운스 로직을 배치해야 안정적이다.
Google Indexing API 자동화는 신규 콘텐츠의 크롤링 대기 시간을 최소화하고 검색 노출 속도를 극대화하는 핵심 SEO 기법이다. 작은 최적화와 자동화 습관이 모여서 검색 유입 증대와 서비스 성장이라는 큰 효과를 만든다는 점을 잊지 말자. 이 글의 서비스 계정 인증 방법과 PHP cURL 연동 코드 부분을 참고해서 CMS 게시물 등록 이벤트에 색인 요청 로직을 추가하면, 새 글이 작성되자마자 구글 검색 엔진에 즉시 반영되는 최종 결과를 얻을 수 있을 것이다.