Search Analytics
Список методов для этого ресурса см. в конце этой страницы.
Представления ресурсов
С этим ресурсом не связаны никакие постоянные данные.
Методы
- запрос
Запрашивайте данные о поисковом трафике с помощью определяемых вами фильтров и параметров. Метод возвращает ноль или более строк, сгруппированных по определяемым вами ключам строк (измерениям). Необходимо определить диапазон дат в один или несколько дней.
Если дата является одним из измерений, дни без данных исключаются из списка результатов. Чтобы узнать, по каким дням имеются данные, выполните запрос без фильтров, сгруппированных по дате, для интересующего диапазона дат.
Результаты отсортированы по убыванию количества кликов. Если две строки имеют одинаковое количество кликов, они сортируются произвольным образом.
См. пример 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 "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-08-29 UTC.
[null,null,["Последнее обновление: 2024-08-29 UTC."],[[["The Search Analytics API allows you to query your website's search traffic data with custom filters and parameters, returning results grouped by specified dimensions."],["You can define date ranges for your queries, but the API might not return all data rows due to internal limitations, prioritizing top results instead."],["Results 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."],["When 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."],["The API offers a \"query\" method to retrieve search traffic data and provides a Python sample for utilizing this method."]]],["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"]]
