Код ошибки

Текст сообщения

Комментарий, возможные причины

Серверные ошибки

52

Сервер авторизации временно недоступен

Сервер API Директа временно не может получить информацию от сервиса Яндекс.OAuth. Попробуйте вызвать метод через некоторое время.

1000

Сервер временно недоступен

Внутренняя ошибка сервера API Директа. Попробуйте вызвать метод через некоторое время. При повторении ошибки обратитесь в службу поддержки.

1001

Ошибка инициализации сервиса

1002

Ошибка операции

1003

Не удалось создать учетную запись пользователя на Яндексе

При создании учетной записи произошла ошибка. Попробуйте вызвать метод через некоторое время.

1004

Не удалось создать клиента

При создании клиента в Директе произошла ошибка. Попробуйте вызвать метод через некоторое время. При повторном вызове используйте другой логин.

1020

Внутренняя ошибка сервера

Список доступных валют не определен. Обратитесь в службу поддержки.

Ошибки аутентификации

53

Ошибка авторизации

Указан недействительный OAuth-токен. Причины, по которым токен становится недействительным, перечислены в разделе Отзыв токеновRevoking tokens документации Яндекс.OAuth.

Незавершенная регистрация приложения

58

Незавершенная регистрация

Необходимо создать заявку на доступ к API и дождаться ее подтверждения.

Ошибки прав

54

Нет прав

• Рекламодатель, чей логин указан в запросе, не является клиентом агентства, от имени которого выполняется запрос.

• Пользователь, от имени которого выполняется запрос на запись/редактирование, имеет право только на чтение данных.

• Аккаунт рекламодателя необходимо перевести в валюту.

• В запросе к сервису AgencyClients указан токен, полученный для представителя рекламодателя.

513

Ваш логин не подключен к Яндекс Директу

Пользователь, от имени которого выполняется запрос, не имеет аккаунта в Директе. Для регистрации аккаунта необходимо создать от имени пользователя рекламную кампанию в веб-интерфейсе. См. также раздел Доступ и авторизация.

3000

Нет доступа к API

• У пользователя, от имени которого выполняется запрос, нет доступа к API.

• Доступ к API закрыт на время перевода кампаний в валюту.

• Пользователь не разрешил доступ к API с данного IP-адреса. См. раздел Ограничение доступа по IP-адресу.

3001

Нет доступа к методу

Доступ к методу AgencyClients.add предоставляется агентству по заявке.

Ограничения, баллы

152

Недостаточно баллов

506

Превышено ограничение на количество соединений

Превышено ограничение на количество одновременных соединений с сервером.

Неподдерживаемые поля, объекты и операции

3500

Не поддерживается

Попытка добавить корректировку, несовместимую с типом кампании.

3600

Ограниченная функциональность

Попытка использовать стратегию PAY_FOR_CONVERSION или PAY_FOR_CONVERSION_PER_CAMPAIGN.

Неверные параметры запроса

4000

Параметры запроса указаны неверно

• Переданные параметры кампании (группы, объявления) не соответствуют типу кампании (группы, объявления).
• Параметры стратегии показа заданы неверно: отсутствует структура с параметрами выбранной стратегии или указана структура с параметрами другой стратегии.
• Неверный формат даты (например, в параметре Timestamp).
• Неверная временная зона.
• Для оптимизации конверсий по ключевым целям необходимо указать хотя бы одну ключевую цель, отличную от вовлеченных сессий.
• Для использования категорий товаров необходимо указать идентификатор фида.

4001

Неверно заданы параметры фильтрации SelectionCriteria

• Превышено количество идентификаторов в массиве.
• В SelectionCriteria должен присутствовать хотя бы один параметр из совокупности (например, Ids, AdGroupIds и CampaignIds).

4002

Неверно указаны параметры страницы

Неверное значение параметра Limit или Offset.

4003

Не передано ни одного из необходимых параметров

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

4004

Передан больше чем один параметр

Указаны взаимоисключающие параметры, только один из которых может присутствовать в запросе.

4005

В одном запросе необходимо использовать Id одного типа

При назначении ставок указаны идентификаторы разнородных объектов (например, в одной структуре Bids — CampaignId , а в другой — AdGroupId).

4006

В одном запросе заданы несовместимые операции

Редактировать уточнения к объявлению можно либо с помощью операций ADD и REMOVE, либо с помощью операции SET.

Неверное значение поля

5000

Поле обязательно для заполнения

Значение обязательного поля пустое или состоит из пробелов.

5001

Превышена допустимая длина

• Превышена максимальная длина значения поля.
• Превышена суммарная длина текстов быстрых ссылок.

5002

Используются недопустимые символы

• Недопустимый символ в ключевой фразе, минус-фразе, тексте быстрой ссылки.
• Неверное использование операторов в ключевой фразе, например отдельно стоящий символ “!”.

5003

Указано пустое значение

Пустая строка, например, в параметре Href в объявлении.

5004

Неверный формат

Некорректное значение поля объекта, например:

• В методе VCards.add:

  • Некорректный идентификатор в системе мгновенного обмена сообщениями в параметре MessengerLogin.
  • Некорректный адрес электронной почты в параметре ContactEmail.
  • Некорректные часы работы в параметре WorkTime.
  • Некорректный номер телефона в структуре Phone.

• В сервисе AdGroups: пустое имя группы.

• В сервисе AdImages: тип или размер файла изображения не соответствует требованиям.

5005

Поле задано неверно

Некорректное значение поля объекта, например:

• Идентификатор объекта не является целым положительным числом.

• В методе VCards.add:

  • Неподдерживаемый тип системы мгновенного обмена сообщениями в параметре MessengerClient.
  • Не указан код страны, код города или номер телефона в структуре Phone.
  • Некорректная или несовместимая с городом станция метро в параметреMetroStationId.

• В методе AgencyClients.add:

  • указана недопустимая валюта клиента. Валюты, в которых агентство может регистрировать клиентов, указаны в результирующем параметре [ClientCurrencies](*ClientCurrencies) метода {#T} API версии Live 4.
  • указана запрещенная площадка или недоступный тип кампании для клиента.

• В методе Clients.add указана запрещенная площадка или недоступный тип кампании.

• В сервисе Sitelinks протокол в ссылке отличен от http и https.

• В сервисе Ads: поле AdImageHash указана некорректная ссылка на изображение или ссылка на несуществующее изображение.

• В сервисе AdGroups: пустой массив RegionIds.

• В сервисе Bids: значение ставки или ContextCoverage выходит за рамки допустимого диапазона.

• В методе Keywords.update: попытка отключить все категории автотаргетинга.

5006

Неверное использование поля

• В сервисе Campaigns:

  • Выбрана стратегия, не соответствующая типу кампании, см. Стратегии показа.

  • Указан недопустимый домен или IP-адрес.

• В сервисе Ads:

  • Слишком длинное слово в заголовке или тексте объявления.
  • Неправильное использование знаков препинания в заголовке или тексте (пробел перед запятой).
  • Основная ссылка дублирует быструю ссылку.

• В сервисе Sitelinks: быстрая ссылка дублирует основную ссылку объявления.

5007

Повторяющийся элемент

Совпадают тексты быстрых ссылок или ссылки ведут на одну и ту же страницу сайта.

5008

Не передано ни одного из необходимых полей

Для объекта должно быть задано хотя бы одно поле из совокупности, однако не указано ни одного.

5009

Передано больше чем одно поле

Для объекта заданы взаимоисключающие поля.

5010

Некорректная длина поля

Слишком короткое поле.

5100

Неправильное использование шаблона

Некорректное использование шаблонов (##) в заголовке и тексте объявления.

5120

Геотаргетинг задан неправильно

• Указан несуществующий идентификатор региона.
• Регион повторяется несколько раз.
• Указаны только минус-регионы.
• Указан минус-регион, совпадающий с регионом показа.
• Указан минус-регион, не содержащийся ни в одном из регионов показа.

5140

Ключевая фраза содержит много слов

Превышено количество ключевых слов во фразе.

5141

Некорректное использование стоп-слов

Ключевая фраза состоит только из стоп-слов.

5142

Превышена допустимая длина слова в ключевой фразе

5160

Минус-слово не может быть словосочетанием

Попытка использовать минус-слово с пробелом.

5161

Некорректное использование минус-слов

• Ключевая фраза состоит только из минус-слов.
• Минус-слово содержит точку (при этом не является десятичным числом).
• Минус-слово начинается с апострофа или заканчивается апострофом.
• Неправильное сочетание специальных символов в ключевой фразе.
• Словосочетание в кавычках не может состоять из минус-слов.
• Нельзя указывать минус-слово, содержащееся в исходной ключевой фразе.
• Суммарная длина фраз превышает максимальное допустимое значение.

5162

Превышена допустимая длина минус-слова

5181

Запрещено изменять рекламируемое приложение

5200

Логин уже используется

Попытка создать клиента с логином, который уже используется на Яндексе другим пользователем.

Неконсистентный объект

6000

Неконсистентное состояние объекта

• Тип группы объявлений не соответствует типу кампании или тип объявления не соответствует типу группы.
• Попытка удалить визитку, которая используется в объявлении.
• Попытка удалить набор быстрых ссылок, который используется в объявлении.
• В объявлении указан набор быстрых ссылок, но не указана основная ссылка.
• В объявлении не указана ни визитка, ни основная ссылка.
• Попытка изменить возрастную метку, если метка не присвоена, а также попытка указать возрастную метку, не соответствующую категории объявления.
• Попытка предоставить клиенту агентства полномочие на управление кампаниями с помощью файлов, если отсутствует полномочие на редактирование кампаний.
• Попытка создать группу медийных объявлений с условием нацеливания по профилю пользователей и с минус-фразами.

6001

Указан объект несоответствующего типа

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

6100

Регион показа не соответствует тексту объявления (заголовок, текст, быстрые ссылки)

При попытке изменить регионы показа в группе нарушено соответствие языку объявления (например, в объявлении символы казахского алфавита, а геотаргетинг меняется на Россию)

6101

Язык не соответствует геотаргетингу

При добавлении или изменении объявления нарушено соответствие регионам показа (например, при геотаргетинге на Россию добавляется объявление на украинском языке)

Объектные ограничения

7000

Количество допустимых элементов превышено или равно нулю

• Количество быстрых ссылок меньше 1 или больше 4
• Попытка добавить более одного условия нацеливания на аудиторию в группу медийных объявлений.

7001

Достигнуто максимальное количество объектов

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

7002

Данный домен трекинговой системы не поддерживается

Ошибки парсинга запроса

55

Операция не найдена

Указано неверное значение ключа method при запросе в формате JSON.

8000

Некорректный запрос

• Не указан OAuth-токен.

• OAuth-токен имеет неверный формат (например, содержит недопустимые символы).

• Не указан логин рекламодателя при запросе от имени агентства.

• Отсутствует обязательный параметр.

• Присутствует неизвестный параметр.

• Некорректный тип параметра, например:

  • строка вместо числа;
  • единичное значение вместо массива;
  • если параметр имеет фиксированный набор значений (пример: FieldNames) — к ошибке приводит значение не из набора.

• Невалидный JSON.

• Отсутствует ключ method при запросе в формате JSON.

• Отсутствует заголовок SOAPAction или тело SOAP-запроса.

Невозможно выполнить операцию

8300

Неверный статус у объекта

• Попытка выполнить операцию с объявлением, группой объявлений или визиткой в архивной или удаленной кампании.
• Попытка отправить на модерацию объявление, не являющееся черновиком, или объявление в группе, не содержащей условий показа, или архивное объявление.
• Попытка удалить объявление, которое запрещено удалять (например, объявление было в показе).
• Попытка остановить или запустить объявление-черновик или архивное объявление.
• Попытка заархивировать активное объявление или объявление-черновик.

8301

Невозможно удалить объект

• Попытка удалить группу, содержащую объявления или условия показа (ключевые фразы, условия нацеливания на аудиторию, условия нацеливания для динамических объявлений).
• Попытка удалить единственную активную фразу в группе (при отсутствии условий нацеливания на аудиторию).
• Попытка удалить кампанию, удаление которой не допускается (например, на кампании есть средства или выставлен счет на оплату).

8302

Невозможно остановить показы

Попытка остановить единственную активную фразу в группе (при отсутствии условий нацеливания на аудиторию).

8303

Невозможно заархивировать объект

• Попытка заархивировать кампанию, на которой есть средства.

• Попытка заархивировать кампанию, которая не остановлена.

• Попытка заархивировать кампанию при недостатке средств на общем счете.

8304

Невозможно разархивировать объект

• Попытка разархивировать кампанию из специального архива (состояние CONVERTED)

• Попытка разархивировать кампанию с превышением ограничения на количество активных кампаний

8305

Невозможно выполнить действие

Попытка изменить сумму дневного бюджета более 3 раз в сутки.

8312

Отчет невозможно построить в режиме online

Отчет с указанными параметрами может быть сформирован только в режиме офлайн. Измените в запросе HTTP-заголовок processingMode. См. раздел mode.

8600

Ошибка подключения общего счета

Объект не найден

8800

Объект не найден

• В HTTP-заголовке Client-Login указан несуществующий логин или логин рекламодателя, не принадлежащего агентству.

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

Ограничения на количество объектов в операциях в одном запросе

9300

Превышено ограничение на количество объектов в одном запросе

Превышено максимальное количество объектов во входном массиве метода

9301

Слишком широкое условие отбора

Превышено максимальное количество выбираемых корректировок. Сумма значений параметров Limit и Offset не должно превышать 120 000.

Зависимости ставок от стратегий

9600

Поле не соответствует установленной стратегии

В запросе отсутствует поле, являющееся обязательным при некоторых условиях (например, Bid в методе Bids.Set для ручных стратегий показа).

9601

Не допускается изменение ставки

• В кампании установлена автоматическая стратегия.
• Изменение ставок в сетях не разрешено, так как показы на сети отключены.
• Изменение ставок в сетях не разрешено, так как установлена стратегия, при которой ставка в сети зависит от ставки на поиске.
• Изменение ставок на поиске не разрешено, так как показы на поиске отключены.

Дублирующиеся объекты

9800

Объект не может присутствовать в запросе более одного раза

В одном вызове метода update, set или delete содержится несколько объектов с одинаковым идентификатором

9801

Объект с указанными характеристиками уже существует

Попытка добавить корректировку, которая уже существует (например, повторно добавить корректировку на мобильных или корректировку для целевой аудитории с тем же самым условием ретаргетинга и подбора аудитории).

9802

Элемент не может присутствовать в списке более одного раза

• В сервисе Campaigns: повторяющееся значение в массиве BlockedIps, CounterIds, NegativeKeywords или повторяющиеся дни в массиве Schedule.
• В сервисе AdGroups:повторяющееся значение в массиве TargetDeviceType.
• В сервисе Ads: повторяющиеся значения в массиве уточнений.

Код предупреждения

Текст сообщения

10000

Объект присутствует в запросе более одного раза

10020

Объект уже остановлен.

10021

Объект не остановлен.

10022

Объект уже заархивирован.

10025

Объект уже помечен как удаленный

10100

Указанная визитка дублирует ранее созданную визитку

10120

Указанный набор быстрых ссылок дублирует ранее созданный набор

10140

Ключевое слово уже существует

10141

Новое ключевое слово создано в результате обновления

10160

Ставка не будет применена

10161

Приоритет не будет применен

10163

Настройка не будет изменена

10165

Параметр не будет применен

10175

Будет использована настройка с более высоким приоритетом

10200

Объявление уже остановлено

10201

Объявление не остановлено

10202

Объявление уже заархивировано

10203

Объявление не заархивировано

10240

Ключевое слово уже остановлено

10241

Ключевое слово не остановлено

10242

Условие нацеливания уже остановлено

10243

Условие нацеливания не остановлено