--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/restrictions.md - href: ru/concepts/restrictions.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/ru/llms.txt # Ограничения на использование ## Ограничения доступа {#access-restriction} Клиенты рекламных агентств могут получить доступ к API: - Если агентство предоставило клиенту доступ в веб-интерфейс только на чтение, то и через API клиент сможет только получать данные. - Если агентство предоставило клиенту право на редактирование кампаний, то клиент сможет управлять своими кампаниями как в веб-интерфейсе, так и через API. Агентство настраивает права доступа своих клиентов с помощью метода [UpdateClientInfo](https://yandex.ru/dev/direct/doc/dg-v4/reference/UpdateClientInfo.html), а также в веб-интерфейсе (флажок **редактировать кампанию** на странице редактирования настроек клиента). Доступ к API можно ограничить по IP-адресу, что повышает информационную безопасность. Список разрешенных IP-адресов можно указать на странице **Управление доступом к API Директа****Direct API access management** на вкладке [Параметры](https://direct.yandex.ru/registered/main.pl?cmd=apiSettings). ## Технические ограничения {#Technical} 1. Допускается не более пяти одновременных запросов к API от лица одного пользователя. 1. Для следующих методов накладывается ограничение на количество вызовов в течение суток: - CreateOrUpdateCampaign ― 100 вызовов для редактирования одной кампании и 100 вызовов для создания кампаний. - [CreateOrUpdateBanners](https://yandex.ru/dev/direct/doc/dg-v4/reference/CreateOrUpdateBanners.html) — 1000 вызовов на кампанию. - [SetAutoPrice](https://yandex.ru/dev/direct/doc/dg-v4/reference/SetAutoPrice.html) ― 100 вызовов на кампанию. - [UpdatePrices](https://yandex.ru/dev/direct/doc/dg-v4/reference/UpdatePrices.html) ― 3000 вызовов на кампанию. За один вызов можно установить цены не более чем для 1000 фраз. - [CreateNewReport](https://yandex.ru/dev/direct/doc/dg-v4/reference/CreateNewReport.html) и [GetBannersStat](https://yandex.ru/dev/direct/doc/dg-v4/live/GetBannersStat.html) ― 300 вызовов на кампанию. - [GetSummaryStat](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetSummaryStat.html) ― 100 вызовов на кампанию. - [GetKeywordsSuggestion](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetKeywordsSuggestion.html) ― 3000 вызовов от лица одного пользователя. - [CreateInvoice](https://yandex.ru/dev/direct/doc/dg-v4/reference/CreateInvoice.html), [GetCreditLimits](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetCreditLimits.html), [PayCampaigns](https://yandex.ru/dev/direct/doc/dg-v4/reference/PayCampaigns.html), [TransferMoney](https://yandex.ru/dev/direct/doc/dg-v4/reference/TransferMoney.html) ― 1000 вызовов от лица одного пользователя. - Остальные методы ― 50 000 вызовов от лица одного пользователя. {% note warning %} Если достигнуто ограничение, до начала следующих суток метод доступен не чаще одного раза в 10 минут. {% endnote %} 1. Для следующих методов накладывается ограничение на количество входных данных: - [CreateOrUpdateBanners](https://yandex.ru/dev/direct/doc/dg-v4/reference/CreateOrUpdateBanners.html) ― до 1000 объявлений. - [UpdatePrices](https://yandex.ru/dev/direct/doc/dg-v4/reference/UpdatePrices.html) ― до 1000 фраз. - [GetSummaryStat](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetSummaryStat.html) ― количество запрошенных кампаний, помноженное на количество дней в выбранном периоде, не должно превышать 1000. - [CreateNewForecast](https://yandex.ru/dev/direct/doc/dg-v4/reference/CreateNewForecast.html) ― до 100 фраз. - [CreateNewWordstatReport](https://yandex.ru/dev/direct/doc/dg-v4/reference/CreateNewWordstatReport.html) ― до 10 фраз в одном запросе и до 1000 фраз в течение суток. - [GetBanners](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetBanners.html) ― до 2000 объявлений или до 10 кампаний в одном запросе. - [GetBannerPhrases](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetBannerPhrases.html), [GetBannerPhrasesFilter](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetBannerPhrasesFilter.html) ― до 1000 объявлений в одном запросе. - [GetClientInfo](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetClientInfo.html) — до 1000 логинов пользователей; - [StopBanners](https://yandex.ru/dev/direct/doc/dg-v4/reference/StopBanners.html), [ResumeBanners](https://yandex.ru/dev/direct/doc/dg-v4/reference/ResumeBanners.html), [ArchiveBanners](https://yandex.ru/dev/direct/doc/dg-v4/reference/ArchiveBanners.html), [UnArchiveBanners](https://yandex.ru/dev/direct/doc/dg-v4/reference/UnArchiveBanners.html), [DeleteBanners](https://yandex.ru/dev/direct/doc/dg-v4/reference/DeleteBanners.html) — до 2000 идентификаторов объявлений. 1. С помощью метода [CreateNewSubclient](https://yandex.ru/dev/direct/doc/dg-v4/reference/CreateNewSubclient.html) рекламное агентство может зарегистрировать не более 100 клиентов в сутки. 1. Для финансовых операций накладываются следующие ограничения: - До 30 финансовых операций в сутки для одной кампании, включая вызовы методов [CreateInvoice](https://yandex.ru/dev/direct/doc/dg-v4/reference/CreateInvoice.html), [PayCampaigns](https://yandex.ru/dev/direct/doc/dg-v4/reference/PayCampaigns.html) и зачисление средств с помощью метода [TransferMoney](https://yandex.ru/dev/direct/doc/dg-v4/reference/TransferMoney.html) (списание средств с помощью метода [TransferMoney](https://yandex.ru/dev/direct/doc/dg-v4/reference/TransferMoney.html) не учитывается). - До 30 финансовых операций в сутки для одного общего счета, суммарно по операциям [Deposit](https://yandex.ru/dev/direct/doc/dg-v4/live/AccountManagement_Deposit.html) и [Invoice](https://yandex.ru/dev/direct/doc/dg-v4/live/AccountManagement_Invoice.html) метода [AccountManagement (Live)](https://yandex.ru/dev/direct/doc/dg-v4/live/AccountManagement.html). - До 3 операций [TransferMoney](https://yandex.ru/dev/direct/doc/dg-v4/live/AccountManagement_TransferMoney.html) метода [AccountManagement (Live)](https://yandex.ru/dev/direct/doc/dg-v4/live/AccountManagement.html) в сутки для одного общего счета (учитывается как зачисление, так и списание средств). 1. Для следующих методов накладывается ограничение на количество отчетов, одновременно хранящихся на сервере: - [CreateNewReport](https://yandex.ru/dev/direct/doc/dg-v4/reference/CreateNewReport.html) — не более 5 отчетов для одного пользователя. - [CreateNewForecast](https://yandex.ru/dev/direct/doc/dg-v4/reference/CreateNewForecast.html) ― не более 5 отчетов для одного пользователя. - [CreateNewWordstatReport](https://yandex.ru/dev/direct/doc/dg-v4/reference/CreateNewWordstatReport.html) ― не более 5 отчетов для одного пользователя. ## Балльные ограничения {#Units} Раз в сутки каждому пользователю API начисляются баллы. Они не накапливаются и каждый день начисляются заново. Баллы используются как средство оплаты за некоторые операции в API (см. ниже). Нехватка баллов не позволяет выполнять эти операции. Метод [GetClientsUnits](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetClientsUnits.html) возвращает количество баллов, доступных пользователю. Баллы списываются при вызове следующих методов: 1. [CreateOrUpdateBanners](https://yandex.ru/dev/direct/doc/dg-v4/reference/CreateOrUpdateBanners.html): - добавление объявления ― 12 баллов; - редактирование объявления ― 4 балла; - добавление фразы ― 2 балла; - редактирование фразы ― 1 балл. 1. [GetKeywordsSuggestion](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetKeywordsSuggestion.html) — 3 балла за фразу. 1. [CreateNewWordstatReport](https://yandex.ru/dev/direct/doc/dg-v4/reference/CreateNewWordstatReport.html) — 10 баллов за фразу. 1. [AdImage (Live)](https://yandex.ru/dev/direct/doc/dg-v4/live/AdImage.html) — 2 балла за загрузку изображения. 1. [AdImageAssociation (Live)](https://yandex.ru/dev/direct/doc/dg-v4/live/AdImageAssociation.html): - добавление привязки изображения к объявлению — 2 балла; - удаление привязки — 1 балл. {% note info %} При добавлении/удалении привязки изображения к объявлению со статусом “Черновик” баллы не списываются. {% endnote %} Пользователь получает тем больше баллов, чем рациональнее использует Яндекс Директ. Нерациональное использование связано, например, с созданием объявлений, которые отклоняются на модерации, с добавлением фраз, имеющих низкий CTR. Подобная практика напрасно расходует ресурсы Яндекс Директа и потому не поощряется. Рациональное использование Яндекс Директа связано с поиском удачных ключевых слов и текстов объявлений, повышающих CTR. Также количество баллов зависит от масштабов кампаний и затрат на рекламу. Поэтому больше баллов получают пользователи, у которых больше баланс кампаний и выше ставки. ## Ограничение на получение результатов торгов {#auction} Каждому рекламодателю предоставляется индивидуальный суточный лимит вызова торгов — ограничение на количество фраз, по которым можно получить результаты торгов. Этот лимит зависит от активности рекламных кампаний — количества показов и кликов и, соответственно, расходования средств. Если количество показов и кликов растет незначительно или на кампаниях осталось мало средств, то частые запросы результатов торгах являются нерациональной нагрузкой на серверы Директа. Поэтому для расчета суточного лимита используется сетка бюджетных порогов, разработанная с учетом статистики кампаний разных типов и тематик. Суточный лимит разделен на 24 часовых интервала и предоставляется по принципу скользящего окна. В текущем часовом интервале рекламодатель может потратить суточный лимит минус количество фраз, по которым были запрошены результаты торгов за предыдущие 23 интервала. Время начала часового интервала может различаться для разных рекламодателей и не совпадать с началом астрономического часа. **Пример**   : Предположим, для рекламодателя суточный лимит запросов в торги составляет 1,5 млн. фраз, а интервалы начинаются в 00:18, 01:18, 02:18 и т. д. Если с 12:18 предыдущего дня до 11:18 текущего дня рекламодатель получил результаты торгов по 1,4 млн. фраз, то с 11:18 до 12:18 он может получить результаты торгов по 100 тыс. фраз. В 12:18 остаток лимита снова перерассчитывается. ![](https://yandex.ru/dev/direct/doc/dg-v4/https://yandex.ru/dev/direct/doc/dg-v4/dg/_assets/window.png) Получением результатов торгов являются следующие запросы к API: - вызов метода [GetBanners](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetBanners.html) или [GetBanners (Live)](https://yandex.ru/dev/direct/doc/dg-v4/live/GetBanners.html), если во входном параметре `GetPhrases` указано значение WithPrices; - вызов метода [GetBannerPhrasesFilter](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetBannerPhrasesFilter.html), если параметр `RequestPrices` не задан или задано значение No; - вызов метода [GetBannerPhrasesFilter (Live)](https://yandex.ru/dev/direct/doc/dg-v4/live/GetBannerPhrasesFilter.html), если параметр `FieldNames` не задан или в массиве присутствует хотя бы одно из значений `Prices`, `Max`, `Min`, ` PremiumMax`, `PremiumMin`, `LowCTR`, `ContextLowCTR`, `Shows`, `Clicks`, `ContextShows`, `ContextClicks`, `CurrentOnSearch`, `LowCTRWarning`, `MinPrice`, `ContextCoverage`, `Coverage`, `AuctionBids`. - вызов метода [GetBannerPhrases](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetBannerPhrases.html) или [GetBannerPhrases (Live)](https://yandex.ru/dev/direct/doc/dg-v4/live/GetBannerPhrases.html). В перечисленных случаях ответ метода содержит HTTP-заголовок `GetPhrasesLimit`, в котором указано: - количество фраз, по которым получены результаты торгов при вызове метода; - доступный остаток суточного лимита; - суточный лимит; - количество секунд до начала следующего часового интервала. **Пример:**   ```httpget GetPhrasesLimit: 1/23553853/23553900/1922 secs ```