Документация
Справочник разработчика
API управления
Управление клиентами Директа
API отчетов v1
Группировки
Клики
Параметры посетителей

Список фильтров

Возвращает информацию о фильтрах счетчика.

Краткое содержание

Синтаксис запроса

counterId — идентификатор счетчика, информацию о фильтрах которого вы хотите получить.

GET https://api-metrika.yandex.ru/management/v1/counter/{counterId}/filters ? [callback
[no-highlight[Функция обратного вызова, которая обрабатывает ответ API.]no-highlight]
=<string>]
callbackФункция обратного вызова, которая обрабатывает ответ API.

Формат ответа


{
    "filters
[no-highlight[

Описание

Фильтры счетчика.

]no-highlight]
" : [ { "id
[no-highlight[

Описание

Идентификатор фильтра. Укажите данный параметр при изменении фильтра счетчика

]no-highlight]
" : < int > , "attr
[no-highlight[

Описание

Тип данных, к которым применяется фильтр.

Возможные значения:

  • referer — реферер;
  • uniq_id — специальный атрибут для фильтра «не учитывать мои визиты».
  • client_ip — IP-адрес;
  • title — заголовок страницы;
  • url — URL страницы;

]no-highlight]
" : < filter_attribute > , "type
[no-highlight[

Описание

Отношение или действие для фильтра.

Возможные значения:

  • equal — равно;
  • contain — содержит;
  • me — мои посещения, используется только с типом данных attr = uniq_id;
  • start — начинается с;
  • interval — в интервале, используется только с типом данных «IP-адрес» (attr = client_ip);
  • only_mirrors — только сайт и зеркала, используется только для типа данных «URL страницы» (attr = url) и типа фильтра «оставить только трафик» (action = include), а также при условии, что для счетчика заданы зеркала.

]no-highlight]
" : < filter_type > , "value
[no-highlight[

Описание

Значение фильтра.

]no-highlight]
" : < string > , "action
[no-highlight[

Описание

Тип фильтра.

Возможные значения:

  • include — оставить только трафик.
  • exclude — исключить трафик;

]no-highlight]
" : < filter_action > , "status
[no-highlight[

Описание

Статус фильтра.

Возможные значения:

  • active — фильтр используется;
  • disabled — фильтр отключен (без удаления).

]no-highlight]
" : < filter_status > , "start_ip
[no-highlight[

Описание

Первый IP-адрес диапазона.

]no-highlight]
" : < string > , "end_ip
[no-highlight[

Описание

Последний IP-адрес диапазона.

]no-highlight]
" : < string > , "with_subdomains
[no-highlight[

Описание

Фильтровать по поддоменам.

]no-highlight]
" : < boolean > }, ... ] }
ПараметрыОписание
filters Фильтры счетчика.
filters
id

Идентификатор фильтра. Укажите данный параметр при изменении фильтра счетчика

attr Тип данных, к которым применяется фильтр.

Возможные значения:

  • referer — реферер;
  • uniq_id — специальный атрибут для фильтра «не учитывать мои визиты».
  • client_ip — IP-адрес;
  • title — заголовок страницы;
  • url — URL страницы;
type Отношение или действие для фильтра.

Возможные значения:

  • equal — равно;
  • contain — содержит;
  • me — мои посещения, используется только с типом данных attr = uniq_id;
  • start — начинается с;
  • interval — в интервале, используется только с типом данных «IP-адрес» (attr = client_ip);
  • only_mirrors — только сайт и зеркала, используется только для типа данных «URL страницы» (attr = url) и типа фильтра «оставить только трафик» (action = include), а также при условии, что для счетчика заданы зеркала.
value Значение фильтра.
action Тип фильтра.

Возможные значения:

  • include — оставить только трафик.
  • exclude — исключить трафик;
status Статус фильтра.

Возможные значения:

  • active — фильтр используется;
  • disabled — фильтр отключен (без удаления).
start_ip Первый IP-адрес диапазона.
end_ip Последний IP-адрес диапазона.
with_subdomains Фильтровать по поддоменам.