Изображение (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, 320 × 50, 320 × 100, 320 × 480, 336 × 280, 480 × 320, 480 × 800, 600 × 500, 600 × 1000, 600 × 1200, 640 × 100, 640 × 200, 640 × 960, 672 × 560, 720 × 1200, 728 × 90, 900 × 750, 900 × 1500, 900 × 1800, 960 × 150, 960 × 300, 960 × 640, 960 × 1440, 960 × 1600, 970 × 250, 1008 × 840, 1200 × 1000, 1200 × 2000, 1200 × 2400, 1280 × 200, 1280 × 400, 1280 × 1920, 1344 × 1120, 1440 × 960, 1456 × 180, 1920 × 1280, 1940 × 500, 2184 × 270, 2910 × 750, 2912 × 360, 3880 × 1000;
размер файла не более 512 КБ.
Допустимые размеры изображений для других типов объявлений:
при соотношении сторон от 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, 320 × 50, 320 × 100, 320 × 480, 336 × 280, 480 × 320, 480 × 800, 600 × 500, 600 × 1000, 600 × 1200, 640 × 100, 640 × 200, 640 × 960, 672 × 560, 720 × 1200, 728 × 90, 900 × 750, 900 × 1500, 900 × 1800, 960 × 150, 960 × 300, 960 × 640, 960 × 1440, 960 × 1600, 970 × 250, 1008 × 840, 1200 × 1000, 1200 × 2000, 1200 × 2400, 1280 × 200, 1280 × 400, 1280 × 1920, 1344 × 1120, 1440 × 960, 1456 × 180, 1920 × 1280, 1940 × 500, 2184 × 270, 2910 × 750, 2912 × 360, 3880 × 1000 | IMAGE_AD |
Тип | Описание | Подходит для типов объявлений |
---|---|---|
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, 320 × 50, 320 × 100, 320 × 480, 336 × 280, 480 × 320, 480 × 800, 600 × 500, 600 × 1000, 600 × 1200, 640 × 100, 640 × 200, 640 × 960, 672 × 560, 720 × 1200, 728 × 90, 900 × 750, 900 × 1500, 900 × 1800, 960 × 150, 960 × 300, 960 × 640, 960 × 1440, 960 × 1600, 970 × 250, 1008 × 840, 1200 × 1000, 1200 × 2000, 1200 × 2400, 1280 × 200, 1280 × 400, 1280 × 1920, 1344 × 1120, 1440 × 960, 1456 × 180, 1920 × 1280, 1940 × 500, 2184 × 270, 2910 × 750, 2912 × 360, 3880 × 1000 | IMAGE_AD |
SMALL — соотношение сторон от 1:1 до 3:4, размер 150 пикселей про меньшей стороне.
UNFIT — тип изображения неизвестен или не поддерживается в данной версии API.
Изображения этих типов невозможно привязать к объявлению.