2020년 12월 9일 수요일
몇 개월 전 Google은 수요가 증가하는 Search Console API의 성능을 개선하기 위한 API 인프라 업그레이드를 발표했습니다. 오늘은 몇 가지 추가 소식을 안내해 드리겠습니다.
- Search Console API에 신규 데이터 및 뉴스 필터 추가
- Sitemaps API에서 도메인 속성 지원
- 검색 문서 이전 방법에 관한 가이드라인
API를 직접 호출한다면 아래 내용을 계속 읽어 보세요.
Search Console API의 신규 데이터 및 뉴스 필터
실적 보고서에는 생성된 지 하루가 지나지 않은 신규 데이터가 이미 포함되고 있습니다. 이제 값이 all로 설정된 요청 매개변수 dataState를 전달하여 API를 통해 이 데이터에 액세스할 수 있습니다. 이 값과 관련하여 반환되는 데이터에는 아직 최종이 아닌 신규 데이터도 포함됩니다. 최종 데이터만 가져오려면 이 매개변수의 값을 final로 설정하거나 매개변수를 전달하지 않으면 됩니다. 매개변수를 전달하지 않으면 기본적으로 최종 데이터만 가져옵니다.
몇 개월 전, 실적 보고서에 Google 검색 필터의 뉴스 탭이 추가되었습니다. 이제 API에서도 이 정보를 사용할 수 있으며 요청에서 searchType 매개변수 값을 news로 설정하여 액세스할 수 있습니다.
Sitemaps API에서 도메인 속성 지원
다른 Search Console API와 마찬가지로 이제 Sitemaps API에서도 도메인 속성을 지원합니다. 도메인 속성에서 사이트맵을 쿼리, 추가, 삭제할 수 있습니다. 예를 들면 다음과 같습니다.
GET https://www.googleapis.com/webmasters/v3/sites/sc-domain:example.com/sitemaps
검색 문서 이전
웹마스터의 검색 문서 지원이 중단됩니다. 외부 API 라이브러리를 사용하여 Search Console API를 쿼리하거나 웹마스터 API 검색 문서를 직접 쿼리하는 경우 다음 변경사항을 반영하도록 API 호출을 업데이트해야 합니다.
API 라이브러리 변경사항
API 라이브러리 변경사항에 관한 소식을 알아보려면 자바 및 Python 빠른 시작 가이드에서 업데이트된 API 사용 가이드를 확인하세요.
자바
웹마스터 서비스와 관련된 모든 가져오기의 경우 webmasters 패키지를 searchconsole.v1 패키지로, 서비스 이름 Webmasters를 SearchConsole로 변경해야 합니다. 예:
- API 서비스 가져오기:
import com.google.api.services.webmasters.Webmasters;import com.google.api.services.searchconsole.v1.SearchConsole; - 응답 객체 가져오기:
import com.google.api.services.webmasters.model.WmxSite;import com.google.api.services.searchconsole.v1.model.WmxSite;
서비스 객체를 제외한 다른 API 객체는 이전과 동일하며 패키지만 변경됩니다.
Python
웹마스터 서비스 객체를 만들 때 다음과 같이 변경합니다.
webmasters_service = build('webmasters', 'v3', http=http)
webmasters_service = build('searchconsole', 'v1', http=http)
마찬가지로, 객체의 작동 방식은 변경되지 않습니다.
직접 검색 문서 쿼리
검색 문서 쿼리의 변경된 내용은 다음과 같습니다.
- URL 변경
https://www.googleapis.com/discovery/v1/apis/webmasters/v3/resthttps://searchconsole.googleapis.com/$discovery/rest - 콘텐츠 변경
name필드가webmasters에서searchconsole로 변경되었습니다.version필드가v3에서v1로 변경되었습니다.
궁금한 사항은 Google 검색 센터 커뮤니티 또는 트위터를 통해 문의해 주시기 바랍니다.