Image (AdImage)
The Image (AdImage) object contains an image. The AdImageHash parameter is used as the image identifier.
An ad can only have one image (or none at all). You can assign the same image to multiple ads. For more information, see Images in ads in Yandex Direct Help.
Service
Use the AdImages service for uploading images as binary data, as well as for deleting images. To upload images asynchronously from a list of URLs, use the Upload action for the AdImage (Live) method in the Live 4 version of the API.
Images can't be edited. If you need to change an image, you must upload a new image and assign it to the ad.
To add an image to an ad or remove it from an ad, use the Ads service (see Ad extensions).
An image undergoes review only when it's added to an ad (see Results of an ad extension review).
You can delete an image only if it is not assigned to any ads. To get a list of ads that a particular image is assigned to, use the Ads service.
Restrictions
The maximum number of images per user is 1000 + 2 × the number of ads.
To check how many images a client can upload and how many have already been uploaded or are being uploaded, use the GetLimits action for the AdImage (Live) method in the Live 4 version of the API.
Requirements for images uploaded via the API
-
Allowed image formats: JPG, PNG, GIF.
-
Acceptable image sizes for image ads:
-
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;
-
Maximum file size of 512 KB.
-
-
Acceptable image sizes for other types of ads:
-
When the aspect ratio is from 1:1 to 3:4/4:3 — from 450 to 5000 pixels on a side.
-
When the aspect ratio is 16:9, each side must be from 1080 × 607 to 5000 × 2812 pixels long.
-
Maximum file size of 10 MB.
-
Type of image
The type of image (the Type parameter returned by the get method) is determined automatically during upload. The types are described in the table:
|
Type |
Description |
Suitable for ad types |
|
REGULAR |
Aspect ratio from 1:1 to 3:4/4:3 Size from 450 to 5000 pixels on each side |
TEXT_AD DYNAMIC_TEXT_AD |
|
WIDE |
Aspect ratio of 16:9 Size from 1080 × 607 to 5000 × 2812 pixels |
TEXT_AD DYNAMIC_TEXT_AD MOBILE_APP_AD |
|
FIXED_IMAGE |
One of the sizes: 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 |
Note
For backward compatibility, the following image types are used:
-
SMALL: Aspect ratio from 1:1 to 3:4; size of 150 pixels on the shorter side.
-
UNFIT: The image type is unknown or not supported by this API version.
Images with this type can't be assigned to an ad.
Hash of the image.
The type of image. See Type of image.