place
Получить список площадок.
Формат запроса
Примечание
Доступна пагинация.
https://adfox.yandex.ru/api/v1
? object=account
& action=list
& actionObject=place
& [actionObjectID=<integer>]
& [actionObjectID2=<integer>]
|
Укажите идентификатор площадки, если требуется получить данные только по одной площадке. Значение по умолчанию: 0 — выводить список всех площадок. |
|
Фильтр по ID сайта. Читайте также: |
* Обязательный параметр
Формат ответа
<response>
<status>
<code>{integer}</code>
</status>
<data>
<result>
<row0>
<ID>{integer}</ID>
<name>{string}</name>
<positionID>{integer}</positionID>
<positionName>{string}</positionName>
<zoneID>{integer}</zoneID>
<zoneName>{string}</zoneName>
<siteID>{integer}</siteID>
<siteName>{string}</siteName>
<categoryID>{integer}</categoryID>
<categoryName>{string}</categoryName>
<bannerTypeID>{integer}</bannerTypeID>
<bannerTypeName>{string}</bannerTypeName>
<presentationTypeID>{integer}</presentationTypeID>
<presentationTypeName>{string}</presentationTypeName>
<dateAdded>{date}</dateAdded>
</row0>
</response>
Параметры ответа
|
Статус обработки запроса. Значение |
|
Элемент списка с соответствующим номером. |
|
Уникальный идентификатор площадки. |
|
Название площадки. |
|
ID расположения. |
|
Название расположения. |
|
ID раздела сайта, в котором находится площадка. |
|
Название раздела сайта, в котором находится площадка. |
|
ID сайта, в котором находится площадка. |
|
Название сайта, в котором находится площадка. |
|
ID категории площадки. |
|
Название категории. |
|
ID типа баннера. |
|
Название типа баннера. |
|
Идентификатор типа представления — указания для сервера, в каком виде производить выгрузку баннеров на сайт. Возможные значения:
|
|
Название типа представления для типа баннера. |
|
Дата добавления раздела. |
Пример запроса и ответа
Запрос:
https://adfox.yandex.ru/api/v1?object=account&action=list&actionObject=place
Ответ:
<response> <status> <code>0</code> </status> <data> <result> <row0> <ID>667290</ID> <name>площадка1</name> <positionID>6</positionID> <positionName><верх страницы></positionName> <zoneID>60119</zoneID> <zoneName>раздел1</zoneName> <siteID>27185</siteID> <siteName>сайт</siteName> <categoryID>0</categoryID> <categoryName/> <bannerTypeID>17</bannerTypeID> <bannerTypeName>600x90</bannerTypeName> <presentationTypeID>0</presentationTypeID> <presentationTypeName>Стандартный</presentationTypeName> <dateAdded>2021-11-27</dateAdded> </row0> </response>
Другие действия с объектом
Читайте также о других действиях с объектом place
:
- добавить площадку;
- добавить баннер по умолчанию;
- удалить площадку;
- получить список размещенных на площадке активных баннеров;
- редактировать параметры площадки;
- получить код вставки с уровня площадки.
Укажите идентификатор площадки, если требуется получить данные только по одной площадке.
Значение по умолчанию: 0 — выводить список всех площадок.
Фильтр по ID сайта.
Читайте также:
Обязательный параметр