---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.ru/dev/direct/doc/en/concepts/units.md
  - https://yandex.ru/dev/direct/doc/ru/concepts/units.md
sourcePath: ru/dg/concepts/units.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/ru/llms.txt

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

## Технические ограничения {#general}

Допускается не более пяти одновременных запросов к API от одного рекламодателя.

## Баллы {#units-desc}

Баллы используются как средство регулирования нагрузки на сервер API. Нехватка баллов не позволяет выполнять запросы к API.

Владельцами баллов являются рекламодатели и агентства. Если запрос к API выполняется от имени представителя рекламодателя, баллы списываются с рекламодателя. Если запрос выполняется от имени представителя агентства, списание баллов зависит от наличия HTTP-заголовка `Use-Operator-Units: true`. Если заголовок указан, баллы списываются с агентства, если не указан — с рекламодателя (клиента агентства). Какой из представителей рекламодателя или агентства выполняет запрос, не имеет значения.

Агентство самостоятельно принимает решение, в каких случаях расходовать собственные баллы, а в каких — баллы своего клиента. Например, собственные баллы позволяют агентству:

- создать рекламные кампании и объявления для нового клиента агентства, у которого пока недостаточно собственных баллов;

- управлять кампаниями действующего клиента агентства, который исчерпал свой лимит баллов.


В ответе на каждый запрос к API в HTTP-заголовке `Units` указано количество баллов:

израсходовано при выполнении запроса / доступный остаток / суточный лимит.

**Пример:**

```text translate=no
Units: 10/20828/64000
```

В HTTP-заголовке ответа `Units-Used-Login` указан логин представителя рекламодателя или агентства, чьи баллы были списаны при выполнении запроса.

### Как начисляются баллы {#units-desc}

Каждому рекламодателю (или агентству) предоставляется индивидуальный суточный лимит баллов. Этот лимит зависит от активности рекламных кампаний — количества показов и кликов и, соответственно, расходования средств.

Если количество показов и кликов растет незначительно или на кампаниях осталось мало средств, то частые и объемные запросы к API являются нерациональной нагрузкой на серверы Директа. Поэтому для расчета суточного лимита используется сетка бюджетных порогов, разработанная с учетом статистики кампаний разных типов и тематик.

Суточный лимит разделен на 24 часовых интервала и предоставляется по принципу скользящего окна. В начале каждого интервала рекламодателю (агентству) начисляется 1/24 суточного лимита. В текущем интервале рекламодатель (агентство) может потратить 1/24 суточного лимита плюс баллы, начисленные и не израсходованные за предыдущие 23 часа.

<!--Картинка с баллами-->

Время начала часового интервала может различаться для разных рекламодателей (агентств) и не совпадать с началом астрономического часа. Например, интервалы могут начинаться в 00:18, 01:18, 02:18 и т. д.

### Как расходуются баллы {#spend}

Баллы могут быть списаны:

- за успешный вызов метода;

- за вызов метода, завершившийся ошибкой;

- за успешную операцию создания или редактирования объекта;

- за ошибку выполнения операции создания или редактирования (предупреждения не учитываются);

- за получение объекта.


Баллы, списываемые **за ошибки**, одинаковы для всех сервисов и методов:

- За ошибку вызова метода — 20 баллов (исключая серверные ошибки — например, недоступность сервера).

- За ошибку операции создания или редактирования объекта— 20 баллов за каждую операцию.


Баллы, списываемые за **успешные вызовы** и **успешные операции** с объектами, приведены в таблице.


#|
|| **Сервис** | **Метод** | **За вызов** | **За объект** ||
||
`AdExtensions`
|
`add`
|
5
|
1
||
|| 
|
`delete`
|
10
|
1
||
|| 
|
`get`
|
5
|
1
||
||
`AdGroups`
|
`add`
|
20
|
20
||
|| 
|
`delete`
|
10
|
0
||
|| 
|
`get`
|
15
|
1
||
|| 
|
`update`
|
20
|
20
||
||
`AdImages`
|
`add`
|
20
|
20
||
|| 
|
`delete`
|
10
|
0
||
|| 
|
`get`
|
15
|
1
||
||
`Ads`
|
`add`
|
20
|
20
||
|| 
|
`archive`
|
15
|
0
||
|| 
|
`delete`
|
10
|
0
||
|| 
|
`get`
|
15
|
1
||
|| 
|
`moderate`
|
15
|
0
||
|| 
|
`resume`
|
15
|
0
||
|| 
|
`suspend`
|
15
|
0
||
|| 
|
`unarchive`
|
40
|
0
||
|| 
|
`update`
|
20
|
20
||
||
`AgencyClients`
|
`add`
|
10
|
1
||
|| 
|
`get`
|
10
|
1
||
|| 
|
`update`
|
10
|
1
||
||
`AudienceTargets`
|
`add`
|
10
|
2
||
|| 
|
`delete`
|
10
|
2
||
|| 
|
`get`
|
1
|
1
||
|| 
|
`resume`
|
10
|
2
||
|| 
|
`setBids`
|
10
|
2
||
|| 
|
`suspend`
|
10
|
2
||
||
`Bids`
|
`get`
|
15
|
3 балла за каждые 2000 фраз[*](*note)
||
|| 
|
`set`
|
25
|
0
||
|| 
|
`setAuto`
|
25
|
0
||
||
`BidModifiers`
|
`add`
|
15
|
1
||
|| 
|
`delete`
|
15
|
0
||
|| 
|
`get`
|
1
|
0
||
|| 
|
`set`
|
2
|
0
||
||
`Businesses`
|
`get`
|
10
|
1
||
||
`Campaigns`
|
`add`
|
10
|
5
||
|| 
|
`archive`
|
10
|
5
||
|| 
|
`delete`
|
10
|
2
||
|| 
|
`get`
|
10
|
1
||
|| 
|
`resume`
|
10
|
5
||
|| 
|
`suspend`
|
10
|
5
||
|| 
|
`unarchive`
|
10
|
5
||
|| 
|
`update`
|
10
|
3
||
||
`Changes`
|
`check`
|
10
|
0
||
|| 
|
`checkCampaigns`
|
10
|
0
||
|| 
|
`checkDictionaries`
|
10
|
0
||
||
`Clients`
|
`get`
|
10
|
0
||
|| 
|
`update`
|
10
|
1
||
||
`Creatives`
|
`get`
|
15
|
1
||
||
`Dictionaries`
|
`get`
|
1
|
0
||
||
`DynamicTextAdTargets`
|
`add`
|
20
|
5
||
|| 
|
`delete`
|
10
|
1
||
|| 
|
`get`
|
15
|
1
||
|| 
|
`resume`
|
10
|
1
||
|| 
|
`setBids`
|
25
|
0
||
|| 
|
`suspend`
|
10
|
1
||
||
`Feeds`
|
`add`
|
20
|
20
||
|| 
|
`delete`
|
10
|
0
||
|| 
|
`get`
|
15
|
1
||
|| 
|
`update`
|
20
|
20
||
||
`KeywordBids`
|
`get`
|
15
|
3 балла за каждые 2000 фраз[*](*note)
||
|| 
|
`set`
|
25
|
0
||
|| 
|
`setAuto`
|
25
|
0
||
||
`Keywords`
|
`add`
|
20
|
2
||
|| 
|
`delete`
|
10
|
1
||
|| 
|
`get`
|
15
|
3 балла за каждые 2000 фраз, если запрошен хотя бы один из параметров `Productivity`, `StatisticsSearch`, ` StatisticsNetwork`.
1 балл за каждые 2000 фраз — в противном случае.
||
|| 
|
`resume`
|
15
|
0
||
|| 
|
`suspend`
|
15
|
0
||
|| 
|
`update`
|
20
|
2
||
||
`KeywordsResearch`
|
`deduplicate`
|
10
|
0
||
|| 
|
`hasSearchVolume`
|
1
|
0
||
||
`Leads`
|
`get`
|
1
|
1
||
||
`NegativeKeywordSharedSets`
|
`add`
|
20
|
20
||
|| 
|
`delete`
|
10
|
0
||
|| 
|
`get`
|
15
|
1
||
|| 
|
`update`
|
20
|
20
||
||
`RetargetingLists`
|
`add`
|
10
|
2
||
|| 
|
`delete`
|
10
|
2
||
|| 
|
`get`
|
1
|
1
||
|| 
|
`update`
|
10
|
2
||
||
`Sitelinks`
|
`add`
|
20
|
20
||
|| 
|
`delete`
|
10
|
0
||
|| 
|
`get`
|
15
|
1
||
||
`SmartAdTargets`
|
`add`
|
20
|
5
||
|| 
|
`delete`
|
10
|
1
||
|| 
|
`get`
|
15
|
1
||
|| 
|
`resume`
|
10
|
1
||
|| 
|
`setBids`
|
10
|
0
||
|| 
|
`suspend`
|
10
|
1
||
|| 
|
`update`
|
10
|
1
||
||
`TurboPages`
|
`get`
|
15
|
1
||
||
`VCards`
|
`add`
|
20
|
20
||
|| 
|
`delete`
|
10
|
0
||
|| 
|
`get`
|
15
|
1
||
|#


{% note info %}

Если методом `Bids.get`, `Keywords.get` или `KeywordBids.get` получено менее 2000 фраз, баллы списываются только за вызов метода.

{% endnote %}

[*note]: Если методом Bids.get, Keywords.get или KeywordBids.get получено менее 2000 фраз, баллы списываются только за вызов метода.