Search Analytics
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.
리소스 표현
이 리소스에는 영구 데이터가 연결되어 있지 않습니다.
메서드
- query
정의한 필터 및 매개변수를 사용하여 검색 트래픽 데이터를 쿼리합니다. 이 메서드는 정의된 행 키 (측정기준)에 따라 그룹화된 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"]
}
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-08-29(UTC)
[null,null,["최종 업데이트: 2024-08-29(UTC)"],[[["\u003cp\u003eThe Search Analytics API allows you to query your website's search traffic data with custom filters and parameters, returning results grouped by specified dimensions.\u003c/p\u003e\n"],["\u003cp\u003eYou can define date ranges for your queries, but the API might not return all data rows due to internal limitations, prioritizing top results instead.\u003c/p\u003e\n"],["\u003cp\u003eResults are sorted by click count in descending order, with arbitrary sorting for rows with identical click counts, and days without data are omitted from the result list.\u003c/p\u003e\n"],["\u003cp\u003eWhen querying with "date" as a dimension, you can identify days with data by performing a filter-less query grouped by date for the desired date range.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers a "query" method to retrieve search traffic data and provides a Python sample for utilizing this method.\u003c/p\u003e\n"]]],["The core content details querying search traffic data using the `query` method. This method retrieves data rows grouped by defined dimensions, such as date, country, or device, within a specified date range. Results are sorted by click count in descending order. The API may not return all data rows and it's limited by Search Console's capabilities. It includes a JSON POST example for specifying start and end dates and dimensions. There is no persistent data.\n"],null,["# Search Analytics\n\n\u003cbr /\u003e\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\nThere is no persistent data associated with this resource.\n\nMethods\n-------\n\n[query](/webmaster-tools/v1/searchanalytics/query)\n\n: Query your search traffic data with filters and parameters that you define. The method returns zero or more rows grouped by the row keys (dimensions) that you define. You must define a date range of one or more days.\n\n When date is one of the dimensions, any days without data are omitted from the result list. To learn which days have data, issue a query without filters grouped by date, for the date range of interest.\n\n Results are sorted by click count descending. If two rows have the same click count, they are sorted in an arbitrary way.\n\n See the [python sample](/webmaster-tools/v1/how-tos/search_analytics) for calling this method.\n\n The API is bounded by internal limitations of Search Console and does not guarantee to return all\n data rows but rather top ones.\n\n [See limits to the amount of data available](/webmaster-tools/v1/how-tos/all-your-data#data_limits). \n **JSON POST Example:** \n\n ```\n POST https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fwww.example.com%2F/searchAnalytics/query?key={MY_API_KEY}\n {\n \"startDate\": \"2015-04-01\",\n \"endDate\": \"2015-05-01\",\n \"dimensions\": [\"country\",\"device\"]\n }\n ```"]]
