get
Возвращает изображения, отвечающие заданным критериям.
Ограничения
Метод возвращает не более 10 000 объектов.
Запрос
Структура запроса в формате JSON:
{
"method": "get",
"params": { /* params */
"SelectionCriteria": { /* AdImageSelectionCriteria */
"AdImageHashes": [(string), ... ],
"Associated": ( "YES" | "NO" )
},
"FieldNames": [( "AdImageHash" | "OriginalUrl" | "PreviewUrl" | "Name" | "Type" | "Subtype" | "Associated" ), ... ], /* required */
"Page": { /* LimitOffset */
"Limit": (long),
"Offset": (long)
}
}
}
Параметр | Тип | Описание | Обяза-тельный |
Структура params (для JSON) / GetRequest (для SOAP) | |||
---|---|---|---|
SelectionCriteria | AdImageSelectionCriteria | Критерий отбора изображений. Если не указан, будут получены все изображения рекламодателя. | Нет |
FieldNames | array of AdImageFieldEnum | Имена параметров изображения, которые требуется получить. | Да |
Page | LimitOffset | Структура, задающая страницу при постраничной выборке данных. | Нет |
Структура AdImageSelectionCriteria | |||
AdImageHashes | array of string | Отбирать изображения с указанными хэшами. Не более 10 000 элементов в массиве. | Нет |
Associated | YesNoEnum | Отбирать изображения по признаку привязки к объявлениям: YES — привязанные, NO — непривязанные. | Нет |
Параметр | Тип | Описание | Обяза-тельный |
Структура params (для JSON) / GetRequest (для SOAP) | |||
---|---|---|---|
SelectionCriteria | AdImageSelectionCriteria | Критерий отбора изображений. Если не указан, будут получены все изображения рекламодателя. | Нет |
FieldNames | array of AdImageFieldEnum | Имена параметров изображения, которые требуется получить. | Да |
Page | LimitOffset | Структура, задающая страницу при постраничной выборке данных. | Нет |
Структура AdImageSelectionCriteria | |||
AdImageHashes | array of string | Отбирать изображения с указанными хэшами. Не более 10 000 элементов в массиве. | Нет |
Associated | YesNoEnum | Отбирать изображения по признаку привязки к объявлениям: YES — привязанные, NO — непривязанные. | Нет |
Ответ
Структура ответа в формате JSON:
{
"result": { /* result */
"AdImages": [{ /* AdImageGetItem */
"AdImageHash": (string),
"Name": (string),
"Associated": ( "YES" | "NO" ),
"Type": ( "SMALL" | "REGULAR" | "WIDE" | "FIXED_IMAGE" | "UNFIT" ),
"Subtype": ( "IMG_240_400" | "IMG_300_250" | "IMG_300_500" | "IMG_300_600" | "IMG_320_50" | "IMG_320_100" | "IMG_320_480" | "IMG_336_280" | "IMG_480_320" | "IMG_480_800" | "IMG_600_500" | "IMG_600_1000" | "IMG_600_1200" | "IMG_640_100" | "IMG_640_200" | "IMG_640_960" | "IMG_672_560" | "IMG_720_1200" | "IMG_728_90" | "IMG_900_750" | "IMG_900_1500" | "IMG_900_1800" | "IMG_960_150" | "IMG_960_300" | "IMG_960_640" | "IMG_960_1440" | "IMG_960_1600" | "IMG_970_250" | "IMG_1008_840" | "IMG_1200_1000" | "IMG_1200_2000" | "IMG_1200_2400" | "IMG_1280_200" | "IMG_1280_400" | "IMG_1280_1920" | "IMG_1344_1120" | "IMG_1440_960" | "IMG_1456_180" | "IMG_1920_1280" | "IMG_1940_500" | "IMG_2184_270" | "IMG_2910_750" | "IMG_2912_360" | "IMG_3880_1000" | "NONE" ),
"OriginalUrl": (string), /* nillable */
"PreviewUrl": (string) /* nillable */
}, ... ],
"LimitedBy": (long)
}
}
Параметр | Тип | Описание |
Структура result (для JSON) / GetResponse (для SOAP) | ||
---|---|---|
AdImages | array of AdImageGetItem | Изображения. |
LimitedBy | long | Порядковый номер последнего возвращенного объекта. Передается в случае, если количество объектов в ответе было ограничено лимитом. См. раздел Постраничная выборка. |
Структура AdImageGetItem | ||
AdImageHash | string | Хэш изображения. |
Name | string | Произвольное наименование изображения. Не более 255 символов. |
Associated | YesNoEnum | Привязано ли изображение хотя бы к одному объявлению клиента. |
Type | AdImageTypeEnum | Тип изображения, см. Тип изображения. |
Subtype | AdImageSubtypeEnum | Размер изображения для типа FIXED_IMAGE. Для изображений с типом, отличным от FIXED_IMAGE, возвращается значение NONE. |
OriginalUrl | string, nillable | Ссылка на изображение в полном размере. |
PreviewUrl | string, nillable | Ссылка на превью изображения. |
Параметр | Тип | Описание |
Структура result (для JSON) / GetResponse (для SOAP) | ||
---|---|---|
AdImages | array of AdImageGetItem | Изображения. |
LimitedBy | long | Порядковый номер последнего возвращенного объекта. Передается в случае, если количество объектов в ответе было ограничено лимитом. См. раздел Постраничная выборка. |
Структура AdImageGetItem | ||
AdImageHash | string | Хэш изображения. |
Name | string | Произвольное наименование изображения. Не более 255 символов. |
Associated | YesNoEnum | Привязано ли изображение хотя бы к одному объявлению клиента. |
Type | AdImageTypeEnum | Тип изображения, см. Тип изображения. |
Subtype | AdImageSubtypeEnum | Размер изображения для типа FIXED_IMAGE. Для изображений с типом, отличным от FIXED_IMAGE, возвращается значение NONE. |
OriginalUrl | string, nillable | Ссылка на изображение в полном размере. |
PreviewUrl | string, nillable | Ссылка на превью изображения. |