--- metadata: - name: generator content: Diplodoc Platform v5.66.1 alternate: - https://yandex.com/dev/direct/doc/en/ads/update.md - https://yandex.com/dev/direct/doc/ru/ads/update.md - href: https://yandex.com/dev/direct/doc/ru/ads/update.md type: text/markdown title: Markdown version - href: https://yandex.com/dev/direct/doc/ru/llms.txt?revision=r22022696 rel: describedby sourcePath: ru/ref-v5/ads/update.md title: update description: Изменяет параметры объявлений — типы объявлений, ограничения, структура запроса и ответа, параметры текстово-графических, медийных, товарных и комбинаторных объявлений --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt?revision=r22022696 # update {% note alert " " %} С 30 июня текстово-графические объявления в Единых перфоманс-кампаниях доступны только для редактирования. Для задач, которые раньше решались с помощью текстово-графических объявлений, создавайте комбинаторные. С 14 июля началось обновление существующих текстово-графических объявлений до комбинаторных. Статистика и настройки, которые вы задавали изначально, после обновления сохранятся. [Подробнее об изменениях](https://yandex.ru/dev/direct/doc/ru/update-tga) {% endnote %} Изменяет параметры объявлений. ### Узнайте больше {#see-also} - [Как работает метод update](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html) - [Как обрабатывать ошибки](https://yandex.ru/dev/direct/doc/dg/concepts/errors.html) ## Ограничения {#restrictions} Для работы с товарными объявлениями используется адрес `https://api.direct.yandex.com/v501/`. Не более 1000 объявлений в одном вызове метода. Не допускается редактирование объявлений со статусом ARCHIVED, см. [Статус и состояние объявления](https://yandex.ru/dev/direct/doc/dg/objects/ad.html#status). ## Запрос {#input} Структура запроса в формате JSON: ```javascript translate=no { "method": "update", "params": { /* params */ "Ads": [{ /* AdUpdateItem */ "Id": (long), /* required */ "TextAd": { /* TextAdUpdate */ "Title": (string), "Title2": (string), /* nillable */ "Text": (string), "Href": (string), /* nillable */ "AgeLabel": ( "AGE_0" | ... | "MONTHS_12" ), "DisplayUrlPath": (string), /* nillable */ "VCardId": (long), /* nillable */ "AdImageHash": (string), /* nillable */ "SitelinkSetId": (long), /* nillable */ "CalloutSetting": { /* AdExtensionSetting */ "AdExtensions": [{ /* AdExtensionSettingItem */ "AdExtensionId": (long), /* required */ "Operation": ( "ADD" | "REMOVE" | "SET" ) /* required */ }, ... ] /* required */ }, /* nillable */ "VideoExtension": { /* VideoExtensionUpdateItem */ "CreativeId": (long) /* nillable */ }, "PriceExtension": { /* PriceExtensionUpdateItem */ "Price": (long), "OldPrice": (long), /* nillable */ "PriceQualifier": ( "FROM" | "UP_TO" | "NONE" ), "PriceCurrency": ( "RUB" | "BYN" | "CHF" | "EUR" | "KZT" | "TRY" | "UAH" | "USD" | "UZS" ) }, /* nillable */ "TurboPageId": (long), /* nillable */ "BusinessId": (long), /* nillable */ "PreferVCardOverBusiness": ( "YES" | "NO" ), "ErirAdDescription" : (string) /* nillable */ }, "TextImageAd": { /* TextImageAdUpdate */ "AdImageHash": (string), "Href": (string), /* nillable */ "TurboPageId": (long), /* nillable */ "ErirAdDescription" : (string) /* nillable */ }, "TextAdBuilderAd": { /* TextAdBuilderAdUpdate */ "Creative": { /* AdBuilderAdUpdateItem */ "CreativeId": (long) /* required */ }, "Href": (string), /* nillable */ "TurboPageId": (long), /* nillable */ "ErirAdDescription" : (string) /* nillable */ }, "CpmBannerAdBuilderAd": { /* CpmBannerAdBuilderAdUpdate */ "Creative": { /* AdBuilderAdUpdateItem */ "CreativeId": (long) /* required */ }, "Href": (string), /* nillable */ "TrackingPixels": { /* ArrayOfString */ "Items": [(string), ... ] /* required */ }, /* nillable */ "TurboPageId": (long), /* nillable */ "ErirAdDescription" : (string) /* nillable */ }, "CpmVideoAdBuilderAd": { /* CpmVideoAdBuilderAdUpdate */ "Creative": { /* AdBuilderAdUpdateItem */ "CreativeId": (long) /* required */ }, "Href": (string), /* nillable */ "TrackingPixels": { /* ArrayOfString */ "Items": [(string), ... ] /* required */ }, /* nillable */ "TurboPageId": (long), /* nillable */ "ErirAdDescription" : (string) /* nillable */ }, "ShoppingAd" : { "SitelinkSetId" : (long) /* nillable */, "CalloutSetting" : { /* nillable */ "AdExtensions" : [{ /* required */ "AdExtensionId" : (long) /* required */, "Operation" : ("ADD"|"REMOVE"|"SET") /* required */ }, ... ] }, "BusinessId" : (long) /* nillable */, "GenerationScopes" : [ ("OFFER"|"LISTING") ], "FeedFilterConditions" : { /* nillable */ "Items" : [{ /* required */ "Operand" : (string) /* required */, "Operator" : ("CONTAINS_ANY"|"EQUALS_ANY"|"EXISTS"|"GREATER_THAN"|"IN_RANGE"|"LESS_THAN"|"NOT_CONTAINS_ALL") /* required */, "Arguments" : [ (string) ] /* required */ }, ... ] }, "TitleSources" : { /* nillable */ "Items" : [ (string) ] /* required */ }, "TextSources" : { /* nillable */ "Items" : [ (string) ] /* required */ }, "DefaultTexts" : [ (string) ], "ListingFeedFilterConditions" : { /* nillable */ "Items" : [{ /* required */ "Operand" : (string) /* required */, "Operator" : ("CONTAINS_ANY"|"EQUALS_ANY"|"EXISTS"|"GREATER_THAN"|"IN_RANGE"|"LESS_THAN"|"NOT_CONTAINS_ALL") /* required */, "Arguments" : [ (string) ] /* required */ }, ... ] }, "ListingTitleSources" : { /* nillable */ "Items" : [ (string) ] /* required */ }, "ListingTextSources" : { /* nillable */ "Items" : [ (string) ] /* required */ } }, "ListingAd" : { "SitelinkSetId" : (long) /* nillable */, "CalloutSetting" : { /* nillable */ "AdExtensions" : [{ /* required */ "AdExtensionId" : (long) /* required */, "Operation" : ("ADD"|"REMOVE"|"SET") /* required */ }, ... ] }, "BusinessId" : (long) /* nillable */, "FeedFilterConditions" : { /* nillable */ "Items" : [{ /* required */ "Operand" : (string) /* required */, "Operator" : ("CONTAINS_ANY"|"EQUALS_ANY"|"EXISTS"|"GREATER_THAN"|"IN_RANGE"|"LESS_THAN"|"NOT_CONTAINS_ALL") /* required */, "Arguments" : [ (string) ] /* required */ }, ... ] }, "TitleSources" : { /* nillable */ "Items" : [ (string) ] /* required */ }, "TextSources" : { /* nillable */ "Items" : [ (string) ] /* required */ }, "DefaultTexts" : [ (string) ] }, "ResponsiveAd": { /* ResponsiveAdUpdate */ "Titles": [(string), ...], "Texts": [(string), ...], "Href": (string), /* nillable */ "AgeLabel": ( "AGE_0" | ... | "MONTHS_12" ), "DisplayUrlPath": (string), /* nillable */ "AdImageHashes": { /* ArrayOfString */ "Items": [(string), ... ] /* required */ }, /* nillable */ "SitelinkSetId": (long), /* nillable */ "CalloutSetting": { /* AdExtensionSetting */ "AdExtensions": [{ /* AdExtensionSettingItem */ "AdExtensionId": (long), /* required */ "Operation": ( "ADD" | "REMOVE" | "SET" ) /* required */ }, ... ] /* required */ }, /* nillable */ "VideoExtensionIds": { /* ArrayOfLong */ "Items": [(long), ... ] /* required */ }, /* nillable */ "PriceExtension": { /* PriceExtensionUpdateItem */ "Price": (long), "OldPrice": (long), /* nillable */ "PriceQualifier": ( "FROM" | "UP_TO" | "NONE" ), "PriceCurrency": ( "RUB" | "BYN" | "CHF" | "EUR" | "KZT" | "TRY" | "UAH" | "USD" | "UZS" ) }, /* nillable */ "BusinessId": (long), /* nillable */ "ErirAdDescription" : (string) /* nillable */ } }, ... ] /* required */ } } ``` #| || **Параметр** | **Тип** | **Описание** | **Обязательный** || || **Структура params (для JSON) / UpdateRequest (для SOAP)** | > | > | > || || `Ads` | array of AdUpdateItem | Объявления, параметры которых требуется изменить. | Да || || **Структура AdUpdateItem** | > | > | > || || `Id` | long | Идентификатор объявления, параметры которого требуется изменить. | Да || || `TextAd` | TextAdUpdate | Параметры текстово-графического объявления. См. [Тип объявления](https://yandex.ru/dev/direct/doc/dg/objects/ad.html#types). | Либо `TextAd`, либо `TextImageAd`, либо `TextAdBuilderAd`, либо `CpmBannerAdBuilderAd`, либо `CpmVideoAdBuilderAd`, либо `ShoppingAd`, либо `ListingAd`, либо `ResponsiveAd`, || || `TextImageAd` | TextImageAdUpdate | Параметры графического объявления, созданного на основе изображения (в группе текстово-графических объявлений). | ^ || || `TextAdBuilderAd` | TextAdBuilderAdUpdate | Параметры графического объявления, созданного на основе креатива (в группе текстово-графических объявлений). | ^ || || `CpmBannerAdBuilderAd` | CpmBannerAdBuilderAdUpdate | Параметры медийного объявления. | ^ || || `CpmVideoAdBuilderAd` | CpmVideoAdBuilderAdUpdate | Параметры медийного видеообъявления (в кампании с типом «Медийная кампания»). | ^ || || `ShoppingAd` | ShoppingAdUpdate | Параметры товарного объявления. | ^ || || `ListingAd` | ListingAdUpdate | Параметры объявления для страниц каталога. {% note warning "Параметр устарел." %} Для работы со страницами каталога используйте `ShoppingAd`. {% endnote %} | ^ || || `ResponsiveAd` | ResponsiveAdUpdate | Параметры комбинаторного объявления. | ^ || || **Структура TextAdUpdate** | > | > | > || || `Title` | string | Заголовок 1. Не более 56 символов с учетом «узких». Каждое слово не более 22 символов. В случае использования [шаблона](https://yandex.ru/support/direct/features/ad-templates.html) символы # не учитываются в длине. {% note info %} «Узкими» считаются символы `!,.;:"` {% endnote %} | Нет || || `Title2` | string, nillable | Заголовок 2. Не более 30 символов без учета «узких» плюс не более 15 «узких» символов. Каждое слово не более 22 символов. В случае использования [шаблона](https://yandex.ru/support/direct/features/ad-templates.html) символы # не учитываются в длине. {% note info %} «Узкими» считаются символы `!,.;:"` {% endnote %} | Нет || || `Text` | string | Текст объявления. Не более 81 символа без учета «узких» плюс не более 15 «узких» символов. Каждое слово не более 23 символов. В случае использования [шаблона](https://yandex.ru/support/direct/features/ad-templates.html) символы # не учитываются в длине. {% note info %} «Узкими» считаются символы `!,.;:"` {% endnote %} | Нет || || `Href` | string, nillable | Ссылка на сайт, куда будет вести объявление. Не более 1024 символов. В случае использования [шаблона](https://yandex.ru/support/direct/features/ad-templates.html) символы # не учитываются в длине. Должна содержать протокол и доменное имя. Может содержать [подстановочные переменные](https://yandex.ru/support/direct/statistics/url-tags.html). | Нет || || `AgeLabel` | AgeLabelEnum | [Возрастная категория](https://yandex.ru/dev/direct/doc/dg/objects/ad.html#age). Если у объявления отсутствует возрастная метка, задать ее нельзя (значение игнорируется). | Нет || || `DisplayUrlPath` | string, nillable | Отображаемая ссылка. Допускается только при наличии параметра `Href`. Не более 20 символов. В случае использования [шаблона](https://yandex.ru/support/direct/features/ad-templates.html) символы # не учитываются в длине. Может содержать буквы, цифры, символы -, №, /, %, #. Запрещены пробел, символ _, двойные символы --, //. См. раздел [Отображаемая ссылка](https://yandex.ru/support/direct/efficiency/display-link.html) Справки Директа. | Нет || || `VCardId` [⚠️](*Deprecated) | long, nillable | {% note warning "Параметр устарел." %} Переданное значение не будет сохранено. {% endnote %} Идентификатор виртуальной визитки. Визитка должна принадлежать той же кампании, что и объявление. | Нет || || `AdImageHash` | string, nillable | Хэш изображения. Для текстово-графических объявлений подходят только изображения с типом REGULAR и WIDE, см. [Тип изображения](https://yandex.ru/dev/direct/doc/dg/objects/adimage.html#type). | Нет || || `SitelinkSetId` | long, nillable | Идентификатор набора быстрых ссылок. Допускается только при наличии параметра `Href`. | Нет || || `CalloutSetting` | AdExtensionSetting, nillable | Уточнения к объявлению: - Чтобы внести изменения в существующий набор уточнений, используйте типы действия ADD и REMOVE (см. описание параметра Operation). - Чтобы заменить существующий набор уточнений новым набором, используйте тип действия SET. - Чтобы отвязать все уточнения, передайте значение nil (null). | Нет || || `VideoExtension` | VideoExtensionUpdateItem | Видеодополнение. См. раздел [Видео](https://yandex.ru/support/direct/features/video-extension.html) Справки Директа. | Нет || || `PriceExtension` | PriceExtensionUpdateItem, nillable | Цена в объявлении. | Нет || || `TurboPageId` [⚠️](*Deprecated) | long, nillable | {% note warning "Параметр устарел." %} Переданное значение не будет сохранено. {% endnote %} Идентификатор Турбо-страницы. | Нет || || `BusinessId` | long, nillable | Идентификатор профиля организации на Яндексе. Получить данные профилей организаций можно с помощью метода [Businesses](https://yandex.com/dev/direct/doc/ru/businesses/businesses.md).[get](https://yandex.com/dev/direct/doc/ru/businesses/get.md). Профиль организации можно привязать к объявлению, только если для него в параметре `IsPublished` возвращается значение YES. {% note info %} Профиль организации доступен по ссылке `https://yandex.ru/profile/` {% endnote %} | Нет || || `PreferVCardOverBusiness` [⚠️](*Deprecated) | YesNoEnum | {% note warning "Параметр устарел." %} Вне зависимости от переданного значения, будет использовано значение `NO`. {% endnote %} Признак, который определяет приоритетность источника данных при показе объявления: YES — визитка, NO — профиль организации. | Нет || || `ErirAdDescription` | string | Описание объекта продвижения. | Нет || || **Структура AdExtensionSetting** | > | > | > || || `AdExtensions` | array of AdExtensionSettingItem | Расширения, которые нужно привязать к объявлению или отвязать от объявления. | Да || || **Структура AdExtensionSettingItem** | > | > | > || || `AdExtensionId` | long | Идентификатор расширения. | Да || || `Operation` | AdExtensionTypeEnum | Тип действия над набором расширений: - ADD — привязать расширение к объявлению; - REMOVE — отвязать расширение от объявления; - SET — заменить набор расширений и привязать расширение к объявлению в составе нового набора. Тип SET несовместим с ADD и REMOVE: для всех элементов в массиве `AdExtensions` должен быть указан тип SET. См. [Примеры](#samples). | Да || || **Структура VideoExtensionUpdateItem** | > | > | > || || `CreativeId` | long, nillable | Идентификатор креатива. Получить идентификатор креатива можно с помощью метода [Creatives](https://yandex.com/dev/direct/doc/ru/creatives/creatives.md).[get](https://yandex.com/dev/direct/doc/ru/creatives/get.md). | Да || || **Структура PriceExtensionUpdateItem** | > | > | > || || `Price` | long | Цена товара или услуги, умноженная на 1 000 000. Целое число, кратное 10 000 (что соответствует цене с двумя знаками после запятой). Максимальное значение — 10 000 000 000 000 000. | Нет || || `OldPrice` | long, nillable | Старая цена товара или услуги, умноженная на 1 000 000. Целое число, кратное 10 000. Старая цена должна быть строго больше цены. | Нет || || `PriceQualifier` | PriceQualifierEnum | Текстовое пояснение к цене: - FROM — «от». - UP_TO — «до». - NONE — нет пояснения. | Нет || || `PriceCurrency` | PriceCurrencyEnum | Валюта, в которой указана цена. | Нет || || **Структура TextImageAdUpdate** | > | > | > || || `AdImageHash` | string | Хэш изображения. Для графических объявлений подходят только изображения с типом FIXED_IMAGE, см. [Тип изображения](https://yandex.ru/dev/direct/doc/dg/objects/adimage.html#type). | Нет || || `Href` | string, nillable | Ссылка на сайт, куда будет вести объявление. Не более 1024 символов. В случае использования [шаблона](https://yandex.ru/support/direct/features/ad-templates.html) символы # не учитываются в длине. Должна содержать протокол и доменное имя. Может содержать [подстановочные переменные](https://yandex.ru/support/direct/statistics/url-tags.html). | Нет || || `TurboPageId` [⚠️](*Deprecated) | long, nillable | {% note warning "Параметр устарел." %} Переданное значение не будет сохранено. {% endnote %} Идентификатор Турбо-страницы. | Нет || || `ErirAdDescription` | string | Описание объекта продвижения. | Нет || || **Структура TextAdBuilderAdUpdate** | > | > | > || || `Creative` | AdBuilderAdUpdateItem | Креатив, созданный в конструкторе креативов. | Нет || || `Href` | string, nillable | Ссылка на сайт, куда будет вести объявление. Не более 1024 символов. В случае использования [шаблона](https://yandex.ru/support/direct/features/ad-templates.html) символы # не учитываются в длине. Должна содержать протокол и доменное имя. Может содержать [подстановочные переменные](https://yandex.ru/support/direct/statistics/url-tags.html). | Нет || || `TurboPageId` [⚠️](*Deprecated) | long, nillable | {% note warning "Параметр устарел." %} Переданное значение не будет сохранено. {% endnote %} Идентификатор Турбо-страницы. | Нет || || `ErirAdDescription` | string | Описание объекта продвижения. | Нет || || **Структура CpmBannerAdBuilderAdUpdate** | > | > | > || || `Creative` | AdBuilderAdUpdateItem | Креатив, загруженный в веб-интерфейсе или созданный в конструкторе креативов. См. раздел [Создание медийной кампании](https://yandex.ru/support/direct/products-cpm-campaign/create.html) Справки Директа. | Нет || || `Href` | string, nillable | Ссылка на сайт, куда будет вести объявление. Не более 1024 символов. В случае использования [шаблона](https://yandex.ru/support/direct/features/ad-templates.html) символы # не учитываются в длине. Должна содержать протокол и доменное имя. Может содержать [подстановочные переменные](https://yandex.ru/support/direct/statistics/url-tags.html). | Нет || || `TrackingPixels` | ArrayOfString, nillable | Может содержать не более двух строк: - Пиксель Яндекс Аудиторий — см. раздел [Пиксель](https://yandex.ru/support/audience/pixel.html) помощи Яндекс Аудиторий. - Счетчик показов ADFOX. В счетчике показов обязательно должен быть макрос `%random%` или `%aw_random%`. Длина каждой строки не более 1024 символов. | Нет || || `TurboPageId` [⚠️](*Deprecated) | long, nillable | {% note warning "Параметр устарел." %} Переданное значение не будет сохранено. {% endnote %} Идентификатор Турбо-страницы. | Нет || || `ErirAdDescription` | string | Описание объекта продвижения. | Нет || || **Структура CpmVideoAdBuilderAdUpdate** | > | > | > || || `Creative` | AdBuilderAdUpdateItem | Креатив, созданный в конструкторе креативов. См. раздел [Видеореклама / Как запустить кампанию](https://yandex.ru/support/direct/products-cpm-campaign-video/create.html) Справки Директа. | Нет || || `Href` | string, nillable | Ссылка на сайт, куда будет вести объявление. Не более 1024 символов. В случае использования [шаблона](https://yandex.ru/support/direct/features/ad-templates.html) символы # не учитываются в длине. Должна содержать протокол и доменное имя. Может содержать [подстановочные переменные](https://yandex.ru/support/direct/statistics/url-tags.html). | Нет || || `TurboPageId` [⚠️](*Deprecated) | long, nillable | {% note warning "Параметр устарел." %} Переданное значение не будет сохранено. {% endnote %} Идентификатор Турбо-страницы. | Нет || || `TrackingPixels` | ArrayOfString, nillable | Счетчик показов ADFOX. В счетчике показов обязательно должен быть макрос `%random%` или `%aw_random%`. Не более 1024 символов. | Нет || || `ErirAdDescription` | string | Описание объекта продвижения. | Нет || || **Структура AdBuilderAdUpdateItem** | > | > | > || || `CreativeId` | long | Идентификатор креатива. Получить идентификатор креатива можно с помощью метода [Creatives](https://yandex.com/dev/direct/doc/ru/creatives/creatives.md).[get](https://yandex.com/dev/direct/doc/ru/creatives/get.md). | Да || || **Структура ShoppingAdUpdate** | > | > | > || || `SitelinkSetId` | long | Идентификатор набора быстрых ссылок. | Нет || || `CalloutSetting` | AdExtensionSetting, nillable | Уточнения к объявлению: - Чтобы внести изменения в существующий набор уточнений, используйте типы действия ADD и REMOVE (см. описание параметра Operation). - Чтобы заменить существующий набор уточнений новым набором, используйте тип действия SET. - Чтобы отвязать все уточнения, передайте значение nil (null). | Нет || || `BusinessId` | long | Идентификатор профиля организации на Яндексе. Получить данные профилей организаций можно с помощью метода [Businesses](https://yandex.com/dev/direct/doc/ru/businesses/businesses.md).[get](https://yandex.com/dev/direct/doc/ru/businesses/get.md). Профиль организации можно привязать к объявлению, только если для него в параметре `IsPublished` возвращается значение YES. {% note info %} Профиль организации доступен по ссылке `https://yandex.ru/profile/` {% endnote %} | Нет || || `GenerationScopes` | array of GenerationScopeEnum | Виды рекламируемых объектов. Можно указать одно или оба значения. Возможные значения: - `OFFER` — товары; - `LISTING` — страницы каталога. | Нет || || `FeedFilterConditions` | FeedFilterConditionsItem | Правила отбора товарных предложений. Не более 30 фильтров в массиве. Суммарная длина правил отбора — не более 65 кБайт (в формате JSON). Товарное предложение отбирается для формирования объявлений, если оно удовлетворяет одновременно всем правилам отбора. Если параметр не задан, для формирования объявлений используются все товарные предложения из фида. | Нет || || `TitleSources` | array of string | Названия полей фида, которые используются для формирования заголовков объявлений. Допустимые названия полей можно получить в методе [feeds.get](https://yandex.com/dev/direct/doc/ru/feeds/get.md) в поле `TitleAndTextSources`. | Нет || || `TextSources` | array of string | Названия полей фида, которые используются для формирования текстов объявлений. Допустимые названия полей можно получить в методе [feeds.get](https://yandex.com/dev/direct/doc/ru/feeds/get.md) в поле `TitleAndTextSources`. | Нет || || `DefaultTexts` | array of string | Тексты по умолчанию. Можно указать только одно значение. | Да || || `ListingFeedFilterConditions` | FeedFilterConditionsItem | Правила отбора страниц каталога из фида. Не более 30 фильтров в массиве. Суммарная длина правил отбора — не более 65 кБайт (в формате JSON). Страница каталога отбирается для формирования объявлений, если она удовлетворяет одновременно всем правилам отбора. Если параметр не задан, для формирования объявлений используются все страницы каталога из фида. | Нет || || `ListingTitleSources` | array of string | Названия полей фида, которые используются для формирования заголовков объявлений страниц каталога. Допустимые названия полей можно получить в методе [feeds.get](https://yandex.com/dev/direct/doc/ru/feeds/get.md) в поле `TitleAndTextSources`. | Нет || || `ListingTextSources` | array of string | Названия полей фида, которые используются для формирования текстов объявлений страниц каталога. Допустимые названия полей можно получить в методе [feeds.get](https://yandex.com/dev/direct/doc/ru/feeds/get.md) в поле `TitleAndTextSources`. | Нет || || **Структура ListingAdUpdate** | > | > | > || || {% note alert %} Тип объявления `LISTING_AD` и структура `ListingAd` устарели, но поддерживаются в режиме совместимости. Для изменения объявлений, продвигающих товары или товары и страницы каталога, используйте `ShoppingAd`. Подробнее см. в разделе [Совместимость с объявлениями страниц каталога](https://yandex.ru/dev/direct/doc/objects/ad.html#listing-ad-compatibility). {% endnote %} | > | > | > || || `SitelinkSetId` | long | Идентификатор набора быстрых ссылок. | Нет || || `CalloutSetting` | AdExtensionSetting, nillable | Уточнения к объявлению: - Чтобы внести изменения в существующий набор уточнений, используйте типы действия ADD и REMOVE (см. описание параметра Operation). - Чтобы заменить существующий набор уточнений новым набором, используйте тип действия SET. - Чтобы отвязать все уточнения, передайте значение nil (null). | Нет || || `BusinessId` | long | Идентификатор профиля организации на Яндексе. Получить данные профилей организаций можно с помощью метода [Businesses](https://yandex.com/dev/direct/doc/ru/businesses/businesses.md).[get](https://yandex.com/dev/direct/doc/ru/businesses/get.md). Профиль организации можно привязать к объявлению, только если для него в параметре `IsPublished` возвращается значение YES. {% note info %} Профиль организации доступен по ссылке `https://yandex.ru/profile/` {% endnote %} | Нет || || `FeedFilterConditions` | FeedFilterConditionsItem | Правила отбора товарных предложений. Не более 30 фильтров в массиве. Суммарная длина правил отбора — не более 65 кБайт (в формате JSON). Товарное предложение отбирается для формирования объявлений, если оно удовлетворяет одновременно всем правилам отбора. Если параметр не задан, для формирования объявлений используются все товарные предложения из фида. | Нет || || `TitleSources` | array of string | Названия полей фида, которые используются для формирования заголовков объявлений. Допустимые названия полей можно получить в методе [feeds.get](https://yandex.com/dev/direct/doc/ru/feeds/get.md) в поле `TitleAndTextSources`. | Нет || || `TextSources` | array of string | Названия полей фида, которые используются для формирования текстов объявлений. Допустимые названия полей можно получить в методе [feeds.get](https://yandex.com/dev/direct/doc/ru/feeds/get.md) в поле `TitleAndTextSources`. | Нет || || `DefaultTexts` | array of string | Тексты по умолчанию. Можно указать только одно значение. | Да || || **Структура CalloutSetting** | > | > | > || || `AdExtensions` | AdExtensions | Расширения для объявления. | Да || || **Структура AdExtensions** | > | > | > || || `AdExtensionId` | long | Идентификатор расширения. | Да || || `Operation` | string | Операция. Возможные значения: - ADD; - REMOVE; - SET. | Да || || **Структура FeedFilterConditionsItem** | > | > | > || || `Operand` | string | Параметр фида. Описание полей для каждого типа фида см. в разделе [Управление фидами](https://yandex.ru/support/direct/ru/feeds/about) Справки Директа. | Да || || `Operator` | StringConditionOperatorEnum | Оператор сравнения. Совместимость полей фида и операторов, а также ограничения на значения см. разделе [Правила отбора для товарных объявлений](https://yandex.ru/dev/direct/doc/dg/objects/ad.html#unified-group-conditions). | Да || || `Arguments` | array of string | Массив строк, с которыми сравнивается операнд. | Да || || **Структура ResponsiveAdUpdate** | > | > | > || || `Titles` | array of string | Набор заголовков. Можно добавить от 1 до 7 заголовков. Не более 56 символов с учетом «узких». Каждое слово не более 22 символов. В случае использования [шаблона](https://yandex.ru/support/direct/features/ad-templates.html) символы # не учитываются в длине. | Да || || `Texts` | array of string | Набор текстов объявления. Можно добавить от 1 до 3 текстов. Не более 81 символа без учета «узких» плюс не более 15 «узких» символов. Каждое слово не более 23 символов. В случае использования [шаблона](https://yandex.ru/support/direct/features/ad-templates.html) символы # не учитываются в длине. | Да || || `Href` | string, nillable | Ссылка на сайт, куда будет вести объявление. Не более 1024 символов. В случае использования [шаблона](https://yandex.ru/support/direct/features/ad-templates.html) символы # не учитываются в длине. Должна содержать протокол и доменное имя. Может содержать [подстановочные переменные](https://yandex.ru/support/direct/statistics/url-tags.html). | Хотя бы один из параметров `Href` или `BusinessId` (могут присутствовать оба). || || `BusinessId` | long | Идентификатор профиля организации на Яндексе. Получить данные профилей организаций можно с помощью метода [Businesses](https://yandex.com/dev/direct/doc/ru/businesses/businesses.md).[get](https://yandex.com/dev/direct/doc/ru/businesses/get.md). Профиль организации можно привязать к объявлению, только если для него в параметре `IsPublished` возвращается значение YES. {% note info %} Профиль организации доступен по ссылке `https://yandex.ru/profile/` {% endnote %} | ^ || || `ErirAdDescription` | string | Описание объекта продвижения. | Нет || || `AdImageHashes` | array of string, nillable | Хэши изображений. Можно указать от 1 до 5 изображений. | Нет || || `SitelinkSetId` | long, nillable | Идентификатор набора быстрых ссылок. Допускается только при наличии параметра `Href`. | Нет || || `DisplayUrlPath` | string, nillable | Отображаемая ссылка. Допускается только при наличии параметра `Href`. Не более 20 символов. В случае использования [шаблона](https://yandex.ru/support/direct/features/ad-templates.html) символы # не учитываются в длине. Может содержать буквы, цифры, символы -, №, /, %, #. Запрещены пробел, символ _, двойные символы --, //. См. раздел [Отображаемая ссылка](https://yandex.ru/support/direct/efficiency/display-link.html) Справки Директа. | Нет || || `CalloutSetting` | AdExtensionSetting, nillable | Уточнения к объявлению: - Чтобы внести изменения в существующий набор уточнений, используйте типы действия ADD и REMOVE (см. описание параметра Operation). - Чтобы заменить существующий набор уточнений новым набором, используйте тип действия SET. - Чтобы отвязать все уточнения, передайте значение nil (null). | Нет || || `VideoExtensionIds` | array of long, nillable | Идентификаторы видеодополнений. Можно добавить от 1 до 6 видео. См. раздел [Видеодополнения](https://yandex.ru/support/direct/features/video-extension.html) Справки Директа. | Нет || || `PriceExtension` | PriceExtensionUpdateItem | Цена в объявлении. | Нет || || `AgeLabel` | AgeLabelEnum | [Возрастная категория](https://yandex.ru/dev/direct/doc/dg/objects/ad.html#age). | Нет || || **Структура AdExtensionSetting** | > | > | > || || `AdExtensions` | array of AdExtensionSettingItem | Расширения, которые нужно привязать к объявлению или отвязать от объявления. | Да || || **Структура AdExtensionSettingItem** | > | > | > || || `AdExtensionId` | long | Идентификатор расширения. | Да || || `Operation` | AdExtensionTypeEnum | Тип действия над набором расширений: - ADD — привязать расширение к объявлению; - REMOVE — отвязать расширение от объявления; - SET — заменить набор расширений и привязать расширение к объявлению в составе нового набора. Тип SET несовместим с ADD и REMOVE: для всех элементов в массиве `AdExtensions` должен быть указан тип SET. См. [Примеры](#samples). | Да || || **Структура PriceExtensionUpdateItem** | > | > | > || || `Price` | long | Цена товара или услуги, умноженная на 1 000 000. Целое число, кратное 10 000 (что соответствует цене с двумя знаками после запятой). Максимальное значение — 10 000 000 000 000 000. | Нет || || `OldPrice` | long, nillable | Старая цена товара или услуги, умноженная на 1 000 000. Целое число, кратное 10 000. Старая цена должна быть строго больше цены. | Нет || || `PriceQualifier` | PriceQualifierEnum | Текстовое пояснение к цене: - FROM — «от». - UP_TO — «до». - NONE — нет пояснения. | Нет || || `PriceCurrency` | PriceCurrencyEnum | Валюта, в которой указана цена. | Нет || |# {% cut "**Устаревшие параметры запроса**" %} ##### {#deprecated-input} #| || **Параметр** | **Тип** | **Описание** | **Статус** || || **Структура MobileAppAdFeatureItem** | > | > | > || || `Feature` | MobileAppFeatureEnum | Тип дополнения: - PRICE — цена; - ICON — иконка; - CUSTOMER_RATING — рейтинг; - RATINGS — количество оценок (отображается, только если включено отображение рейтинга). Если тип дополнения отсутствует в массиве `Features`, дополнение не отображается. | Если тип дополнения отсутствует в массиве `Features`, дополнение не отображается. | Параметр устарел и больше не поддерживается. Если тип дополнения отсутствует в массиве `Features`, дополнение не отображается. | || || `Enabled` | YesNoEnum | Отображать ли дополнение в объявлении. {% note info %} - Если дополнение не удалось загрузить из магазина приложений, для него допустимо значение YES, однако это дополнение не отображается при показе объявления. - Количество оценок отображается только вместе с рейтингом: если для типа CUSTOMER_RATING задано NO, а для RATINGS — YES, количество оценок не отображается. {% endnote %} | | Параметр устарел и больше не поддерживается. | || |# {% endcut %} ## Ответ {#output} Структура ответа в формате JSON: ```javascript translate=no { "result": { /* result */ "UpdateResults": [{ /* ActionResult */ "Id": (long), "Warnings": [{ /* ExceptionNotification */ "Code": (int), /* required */ "Message": (string), /* required */ "Details": (string) }, ... ], "Errors": [{ /* ExceptionNotification */ "Code": (int), /* required */ "Message": (string), /* required */ "Details": (string) }, ... ] }, ... ] /* required */ } } ``` #| || **Параметр** | **Тип** | **Описание** || || **Структура result (для JSON) / UpdateResponse (для SOAP)** | > | > || || `UpdateResults` | array of ActionResult | Результаты изменения параметров объявлений. || || **Структура ActionResult** | > | > || || `Id` | long | Идентификатор объявления. Возвращается в случае отсутствия ошибок, см. раздел [Операции над массивом объектов](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html). || || `Warnings` | array of ExceptionNotification | Предупреждения, возникшие при выполнении операции. || || `Errors` | array of ExceptionNotification | Ошибки, возникшие при выполнении операции. || |# ## Примеры {#samples} **Внесение изменений в набор расширений к объявлению** К объявлению были привязаны уточнения с идентификаторами 111, 112, 113. После выполнения запроса к объявлению будут привязаны уточнения с идентификаторами 111, 112, 114, 115. ```javascript translate=no { "method": "update", "params": { "Ads": [{ "Id": 7654321, "TextAd": { "CalloutSetting": { "AdExtensions": [{ "AdExtensionId": 114, "Operation": "ADD" }, { "AdExtensionId": 115, "Operation": "ADD" }, { "AdExtensionId": 113, "Operation": "REMOVE" }] } } }] } } ``` **Замена набора расширений** К объявлению были привязаны уточнения с идентификаторами 111, 112, 113. После выполнения запроса к объявлению будут привязаны уточнения с идентификаторами 113, 114. ```javascript translate=no { "method": "update", "params": { "Ads": [{ "Id": 7654321, "TextAd": { "CalloutSetting": { "AdExtensions": [{ "AdExtensionId": 113, "Operation": "SET" }, { "AdExtensionId": 114, "Operation": "SET" }] } } }] } } ``` [*Deprecated]: Устарел и больше не поддерживается. [*Deprecated_tgo]: Устарел. Поддерживается в режиме совместимости.