Изображение (AdImage)

Объект Изображение (AdImage) содержит изображение. В качестве идентификатора изображения используется параметр AdImageHash.

У объявления может быть только одно изображение (либо ни одного). Одно и то же изображение можно привязать к нескольким объявлениям. Изображение демонстрируется только при показе объявления в сетях (Рекламной сети Яндекса и внешних сетях). Подробнее в разделе Изображения в объявлении помощи Директа.

Сервис

Для загрузки изображений в виде бинарных данных, а также для удаления изображений предназначен сервис AdImages. Для асинхронной загрузки изображений по списку URL используйте операцию Upload метода AdImage (Live) API версии Live 4.

Редактирование изображений не предусмотрено. Если требуется изменить изображение, необходимо загрузить новое изображение и привязать его к объявлениям.

Привязать изображение к объявлению или отвязать от объявления можно с помощью сервиса Ads, см. Добавление визитки, изображения, быстрых ссылок, уточнений, видеодополнения.

Изображение проходит модерацию только в связке с объявлением, см. Результат модерации дополнений.

Удалить изображение можно только в случае, если оно не привязано ни к одному объявлению. Получить список объявлений, к которым привязано конкретное изображение, можно с помощью сервиса Ads.

Ограничения

Количество изображений у рекламодателя не может превышать 1000 + 2 × количество объявлений.

Проверить, сколько изображений клиент может загрузить и сколько уже загружено/загружается, можно с помощью операции GetLimits метода AdImage (Live) API версии Live 4.

Требования к изображениям, загружаемым через API

  • Допустимые форматы изображений: JPG, PNG, GIF.

  • Допустимые размеры изображений для графических объявлений:

    • 240 × 400, 300 × 250, 300 × 500, 300 × 600, 336 × 280, 640 × 100, 640 × 200, 640 × 960, 728 × 90, 960 × 640, 970 × 250;

    • размер файла не более 120 КБ.

  • Допустимые размеры изображений для других типов объявлений:

    • при соотношении сторон от 1:1 до 3:4/4:3 — от 450 до 5000 пикселей по каждой стороне;

    • при соотношении сторон 16:9 — от 1080 × 607 до 5000 × 2812 пикселей;

    • размер файла не более 10 МБ.

Тип изображения

Тип изображения (параметр Type, возвращаемый методом get) определяется автоматически при загрузке. Описание типов представлено в таблице:

ТипОписаниеПодходит для типов объявлений
REGULAR

Соотношение сторон от 1:1 до 3:4/4:3

Размер от 450 до 5000 пикселей по каждой стороне

TEXT_AD

DYNAMIC_TEXT_AD

WIDE

Соотношение сторон 16:9

Размер от 1080 × 607 до 5000 × 2812 пикселей.

TEXT_AD

DYNAMIC_TEXT_AD

MOBILE_APP_AD

FIXED_IMAGEОдин из размеров 240 × 400, 300 × 250, 300 × 500, 300 × 600, 336 × 280, 640 × 100, 640 × 200, 640 × 960, 728 × 90, 960 × 640, 970 × 250IMAGE_AD
Примечание. Для обеспечения обратной совместимости используются следующие типы изображений:
  • SMALL — соотношение сторон от 1:1 до 3:4, размер 150 пикселей про меньшей стороне.

  • UNFIT — тип изображения неизвестен или не поддерживается в данной версии API.

Изображения этих типов невозможно привязать к объявлению.