defaultBanner

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

  1. Формат запроса
  2. Формат ответа
  3. Параметры ответа
  4. Другие действия с объектом

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

Примечание. Доступна пагинация.
https://api.adfox.ru/v1/API.php
 ? loginAccount=<string>
 & loginPassword=<string>
 & object=account
 & action=list
 & actionObject=defaultBanner
 & [listPlaceIDs=<integer>]
 & [listAdNetworkIDs=<integer>]
Query-параметры
listPlaceIDs

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

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

listAdNetworkIDs

Список ID рекламных сетей.

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

Параметр является обязательным, если не указан listPlaceIDs.

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

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

<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

Статус обработки запроса. Расшифровку смотрите в разделе Обработка ошибок.

rows

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

rowN

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

adNetworkID

ID рекламной сети.

adNetworkName

Название рекламной сети.

siteID

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

siteName

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

bannerTypeID

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

bannerTypeName

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

presentationTypeName

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

defaultCodeType

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

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

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

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

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

Запрос:

https://api.adfox.ru/v1/API.php?loginAccount={your_login}&loginPassword={sha256_your_password}&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: