defaultBanner

Получить список баннеров по умолчанию для площадок.

Формат запроса

Примечание

Доступна пагинация.

https://adfox.yandex.ru/api/v1
  ? object=account
  & action=list
  & actionObject=defaultBanner
  & [listPlaceIDs=<integer>]

listPlaceIDs

Список ID площадок.

Разделитель — запятая.

* Обязательный параметр

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

<response>
  <status>
    <code>{integer}</code>
  </status>
  <data>
   <result>
    <row0>
     <adNetworkID>{integer}</adNetworkID>
     <adNetworkName>{string}</adNetworkName>
     <siteID>{integer}</siteID>
     <siteName>{string}</siteName>
     <placeID>{integer}</placeID>
     <bannerTypeID>{integer}</bannerTypeID>
     <bannerTypeName>{string}</bannerTypeName>
     <presentationTypeName>{string}</presentationTypeName>
     <defaultCodeType>{integer}</defaultCodeType>
     <defaultCode>{string}</defaultCode>
    </row0>
</response>

Параметры ответа

code

Статус обработки запроса. Значение 0 — запрос выполнен успешно. Расшифровку смотрите в разделе Обработка ошибок.

rows

Количество элементов в дереве ответа.

rowN

Порядковый номер элемента в дереве ответа, где N — число от 0 до rows-1 (где rows — общее количество элементов в ответе).

siteID

ID сайта в управлении.

siteName

Название сайта в управлении.

bannerTypeID

ID типа баннера.

bannerTypeName

Название типа баннера.

presentationTypeName

Тип представления для типа баннера.

defaultCodeType

Тип кода для баннера по умолчанию.

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

  • 0 — HTML-код;
  • 1 — JavaScript-код.

defaultCode

Код баннера по умолчанию.

Пример запроса и ответа

Запрос:

https://adfox.yandex.ru/api/v1?object=account&action=list&actionObject=defaultBanner&listAdNetworkIDs=506,566

Ответ:

<response>
  <status>
    <code>0</code>
  </status>
  <data>
   <result>
    <row0>
     <adNetworkID>506</adNetworkID>
     <adNetworkName>240x400</adNetworkName>
     <siteID>24138</siteID>
     <siteName>test site</siteName>
     <placeID>632208</placeID>
     <bannerTypeID>82654</bannerTypeID>
     <bannerTypeName>728x90js</bannerTypeName>
     <presentationTypeName>Безразмерный</presentationTypeName>
     <defaultCodeType>0</defaultCodeType>
     <defaultCode><p></p></defaultCode>
    </row0>
</response>

Другие действия с объектом

Читайте также о других действиях с объектом defaultBanner:

Предыдущая
Следующая