Search Analytics

이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.

리소스 표현

이 리소스에는 영구 데이터가 연결되어 있지 않습니다.

방법

query

정의한 필터 및 매개변수를 사용하여 검색 트래픽 데이터를 쿼리합니다. 이 메서드는 정의한 row key (측정기준)로 그룹화된 0개 이상의 행을 반환합니다. 1일 이상의 기간을 정의해야 합니다.

날짜가 측정기준 중 하나인 경우 데이터가 없는 날짜는 결과 목록에서 생략됩니다. 데이터가 있는 날짜를 알아보려면 필터를 날짜 없이 그룹화한 다음 관심 있는 기간에 대해 쿼리를 실행합니다.

결과는 클릭 수를 기준으로 내림차순으로 정렬됩니다. 두 행의 클릭수가 같으면 임의의 방식으로 정렬됩니다.

이 메서드를 호출하는 방법은 Python 샘플을 참고하세요.

이 API는 Search Console의 내부 제한사항이 있으며 모든 데이터 행이 아니라 최상위 행을 반환한다고 보장하지 않습니다.

사용 가능한 데이터 양의 한도를 확인하세요.

JSON POST 예:

POST https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fwww.example.com%2F/searchAnalytics/query?key={MY_API_KEY}
{
  "startDate": "2015-04-01",
  "endDate": "2015-05-01",
  "dimensions": ["country","device"]
}