2022년 1월 31일 월요일
드디어 Google Search Console의 새로운 URL Inspection API가 출시됩니다. 이제 Search Console에서 관리하는 속성의 URL 수준 데이터에 프로그래매틱 방식으로 액세스하세요.
Search Console API를 사용하면 외부 애플리케이션 및 제품을 통해 Search Console 외부의 데이터에 액세스할 수 있습니다. 여러 개발자와 검색엔진 최적화 도구는 이미 이 API를 사용하여 속성 및 사이트맵을 확인, 추가, 삭제하는 맞춤 솔루션을 구축하고 Google 검색 실적 데이터에 관한 고급 쿼리를 실행하고 있습니다.
Google이 제공하는 새 URL Inspection API를 개발자를 위한 도구로 사용하여 페이지를 디버그하고 최적화하시기 바랍니다. Search Console에 있는 색인 생성된 URL 버전에 관한 데이터를 요청하면 이 API는 현재 URL 검사 도구에서 제공되는 색인 생성된 정보를 반환합니다.
새 API 사용
새 API의 사용 방법을 알아보려면 API 개발자 문서를 참고하세요. 요청 매개변수에는 검사할 URL과 Search Console에서 정의한 속성의 URL이 포함됩니다.
색인 상태, AMP, 리치 결과, 모바일 사용 편의성 등 Search Console의 정보가 포함된 분석 결과가 응답으로 반환됩니다. 자세한 내용은 매개변수 목록 및 색인 생성된 URL 결과 설명을 참고하세요.
API를 호출하면 관련된 모든 결과를 담은 응답을 받게 되고, 요청이 실패할 경우 오류 메시지가 표시됩니다. 응답에 특정 분석 결과가 누락되었다면 검사 대상 URL에 해당 분석을 사용할 수 없다는 의미입니다. 다음은 이 API로 얻을 수 있는 응답의 예시입니다.
{
"inspectionResult": {
"inspectionResultLink": "https://search.google.com/search-console/inspect?resource_id=https://developers.google.com/search/&id=odaUL5Dqq3q8n0EicQzawg&utm_medium=link",
"indexStatusResult": {
"verdict": "PASS",
"coverageState": "Indexed, not submitted in sitemap",
"robotsTxtState": "ALLOWED",
"indexingState": "INDEXING_ALLOWED",
"lastCrawlTime": "2022-01-31T08:39:51Z",
"pageFetchState": "SUCCESSFUL",
"googleCanonical": "https://developers.google.com/search/help/site-appearance-faq",
"userCanonical": "https://developers.google.com/search/help/site-appearance-faq",
"referringUrls": [
"https://developers.google.com/search/updates",
"https://developers.google.com/search/help/crawling-index-faq"
],
"crawledAs": "MOBILE"
},
"mobileUsabilityResult": {
"verdict": "PASS"
},
"richResultsResult": {
"verdict": "PASS",
"detectedItems": [
{
"richResultType": "Breadcrumbs",
"items": [
{
"name": "Unnamed item"
}
]
},
{
"richResultType": "FAQ",
"items": [
{
"name": "Unnamed item"
}
]
}
]
}
}
}
잠재적 사용 사례
새로운 API를 빌드하는 과정에서 Google은 다양한 검색엔진 최적화 전문가와 게시자에게 이 데이터로 솔루션을 만들 때 API를 어떻게 사용할 것인지 문의했습니다. 다음은 주목할 만한 사용 사례입니다.
- 검색엔진 최적화 도구 및 대행사는 중요한 페이지 및 단일 페이지 디버깅 옵션에 관한 지속적인 모니터링을 제공할 수 있습니다. 예를 들어 사용자가 선언한 표준 페이지와 Google에서 선택한 표준 페이지 간에 차이가 있는지 확인하거나 페이지 그룹에서 구조화된 데이터 문제를 디버깅할 수 있습니다.
- CMS 및 플러그인 개발자는 페이지 또는 템플릿 수준의 통계 및 기존 페이지에 대한 지속적 검사를 추가할 수 있습니다. 예를 들어 시간 경과에 따른 주요 페이지의 변화를 모니터링하여 문제를 진단하고 해결의 우선순위를 정할 수 있습니다.
사용량 한도
개발자 문서에서 Search Console API 사용량 한도에 관한 자세한 설명을 확인할 수 있습니다. 특히 URL Inspection API와 관련하여 Search Console 웹사이트 속성(동일 사이트에 대한 쿼리 호출)에 따라 다음과 같은 할당량이 적용됩니다.
- 쿼리 2,000개/일
- 쿼리 600개/분
의견
새로운 API는 Google 검색 데이터를 이용한 혁신의 기회를 관련 생태계에 선사할 것입니다. Google은 개발자와 검색엔진 최적화 전문가들이 Search Console API를 활용하여 빌드한 솔루션을 항상 기대하고 있습니다.
질문이나 의견이 있다면 트위터를 통해 문의하거나 검색 센터 커뮤니티에 질문을 올려 주시기 바랍니다.