Ошибки и предупреждения

В разделе приведены коды и описание ошибок и предупреждений в ответных сообщениях API Яндекс.Директа версии 5.

  1. Ошибки
  2. Предупреждения

Ошибки

Код ошибки Текст сообщения Комментарий, возможные причины
Серверные ошибки
52 Сервер авторизации временно недоступен Сервер API Директа временно не может получить информацию от сервиса Яндекс.OAuth. Попробуйте вызвать метод через некоторое время.
1000 Сервер временно недоступен Внутренняя ошибка сервера API Директа. Попробуйте вызвать метод через некоторое время. При повторении ошибки обратитесь в службу поддержки.
1001 Ошибка инициализации сервиса
1002 Ошибка операции
1003 Не удалось создать учетную запись пользователя на Яндексе При создании учетной записи произошла ошибка. Попробуйте вызвать метод через некоторое время.
1004 Не удалось создать клиента При создании клиента в Директе произошла ошибка. Попробуйте вызвать метод через некоторое время. При повторном вызове используйте другой логин.
1020 Внутренняя ошибка сервера Список доступных валют не определен. Обратитесь в службу поддержки.
Ошибки аутентификации
53 Ошибка авторизации

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

Незавершенная регистрация приложения
58 Незавершенная регистрация Необходимо создать заявку на доступ к API и дождаться ее подтверждения.
Ошибки прав
54 Нет прав
  • Рекламодатель, чей логин указан в запросе, не является клиентом агентства, от имени которого выполняется запрос.

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

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

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

513 Ваш логин не подключен к Яндекс.Директу Пользователь, от имени которого выполняется запрос, не имеет аккаунта в Директе. Для регистрации аккаунта необходимо создать от имени пользователя рекламную кампанию в веб-интерфейсе. См. также раздел Доступ и авторизация.
3000 Нет доступа к API
  • У пользователя, от имени которого выполняется запрос, нет доступа к API.

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

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

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

Метод AgencyClients.add недоступен агентству.

Ограничения, баллы
152 Недостаточно баллов
506 Превышено ограничение на количество соединений Превышено ограничение на количество одновременных соединений с сервером.
Неподдерживаемые поля, объекты и операции
3500 Не поддерживается
  • Попытка добавить корректировку, несовместимую с типом кампании.
Неверные параметры запроса
4000 Параметры запроса указаны неверно
  • Переданные параметры кампании (группы, объявления) не соответствуют типу кампании (группы, объявления).
  • Параметры стратегии показа заданы неверно: отсутствует структура с параметрами выбранной стратегии или указана структура с параметрами другой стратегии.
  • Неверный формат даты (например, в параметре Timestamp).
  • Неверная временная зона.
4001 Неверно заданы параметры фильтрации SelectionCriteria
  • Превышено количество идентификаторов в массиве.
  • В SelectionCriteria должен присутствовать хотя бы один параметр из совокупности (например, Ids, AdGroupIds и CampaignIds).
4002 Неверно указаны параметры страницы Неверное значение параметра Limit или Offset.
4003 Не передано ни одного из необходимых параметров В запросе должен присутствовать хотя бы один параметр из совокупности, однако не указано ни одного.
4004 Передан больше чем один параметр Указаны взаимоисключающие параметры, только один из которых может присутствовать в запросе.
4005 В одном запросе необходимо использовать Id одного типа При назначении ставок указаны идентификаторы разнородных объектов (например, в одной структуре BidsCampaignId , а в другой — 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.
  • В сервисе Sitelinks протокол в ссылке отличен от http и https.
  • В сервисе Ads: поле AdImageHash указана некорректная ссылка на изображение или ссылка на несуществующее изображение.
  • В сервисе AdGroups: пустой массив RegionIds.
  • В сервисе Bids: значение ставки или ContextCoverage выходит за рамки допустимого диапазона.
  • В методе AgencyClients.add: указана недопустимая валюта клиента. Валюты, в которых агентство может регистрировать клиентов, указаны в результирующем параметре ClientCurrencies метода GetClientInfo (Live) API версии Live 4.
5006 Неверное использование поля
  • В сервисе Campaigns:

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

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

  • В сервисе Ads:

    • Слишком длинное слово в заголовке или тексте объявления.
    • Неправильное использование знаков препинания в заголовке или тексте (пробел перед запятой).
    • Основная ссылка дублирует быструю ссылку.
  • В сервисе Sitelinks: быстрая ссылка дублирует основную ссылку объявления.
5007 Повторяющийся элемент Совпадают тексты быстрых ссылок или ссылки ведут на одну и ту же страницу сайта.
5008 Не передано ни одного из необходимых полей Для объекта должно быть задано хотя бы одно поле из совокупности, однако не указано ни одного.
5009 Передано больше чем одно поле Для объекта заданы взаимоисключающие поля.
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 раз в сутки.
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 Параметр не будет применен
10200 Объявление уже остановлено
10201 Объявление не остановлено
10202 Объявление уже заархивировано
10203 Объявление не заархивировано
10240 Ключевое слово уже остановлено
10241 Ключевое слово не остановлено
10242 Условие нацеливания уже остановлено
10243 Условие нацеливания не остановлено