assistant

Добавить пользователя с типом «ассистент». Ассистенты — это пользователи, которые помогают администратору в его работе. Ассистентам доступны отчеты по кампаниям и управление своими кампаниями.

Формат запроса

https://adfox.yandex.ru/api/v1
 ? object=account
 & action=add
 & actionObject=assistant
 & account=<string>
 & eMail=<string>
 & [company=<string>]
 & [firstName=<string>]
 & [lastName=<string>]
 & [isCreateOwnCampaigns=<integer>]
 & [isAdvertisers=<integer>]
 & [isModifyAllCampaigns=<integer>]
 & [isModifyOwnCampaigns=<integer>]
 & [isViewAllCampaigns=<integer>]
 & [isViewOwnCampaigns=<integer>]
 & [isWebsite=<integer>]
 & [isCommonReports=<integer>]

account*

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

Может содержать русские и латинские буквы, цифры и любые символы

eMail*

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

company

Название компании.

firstName

Имя пользователя.

lastName

Фамилия пользователя.

isCreateOwnCampaigns

Настройка прав доступа. Возможность создавать собственные кампании.

Доступные значения:

  • 1 — включить;
  • 0 — выключить. Значение по умолчанию: 0.

isAdvertisers

Настройка прав доступа. Возможность создавать собственных рекламодателей.

Допустимые значения:

  • 1 — включить;
  • 0 — выключить. Значение по умолчанию: 0.

isModifyAllCampaigns

Настройка прав доступа. Управление всеми кампаниями:

  • 1 — включить;
  • 0 — выключить. Значение по умолчанию: 0.

isModifyOwnCampaigns

Настройка прав доступа. Управление приписанными к ассистенту рекламными кампаниями.

Допустимые значения:

  • 1 — включить;

  • 0 — выключить. Включается автоматически, если:

  • isCreateOwnCampaigns=1 — разрешено создание собственных кампаний;

  • isModifyAllCampaigns=1 — разрешено управление всеми кампаниями. Значение по умолчанию: 0.

isViewAllCampaigns

Настройка прав доступа. Просмотр всех кампаний.

Допустимые значения:

  • 1 — включить;
  • 0 — выключить. Включается автоматически, если isModifyAllCampaigns=1 (разрешено управление всеми кампаниями).

Значение по умолчанию: 0.

isViewOwnCampaigns

Настройка прав доступа. Просмотр приписанных к ассистенту кампаний.

Допустимые значения:

  • 1 — включить;

  • 0 — выключить. Включается автоматически, если:

  • isModifyAllCampaigns=1 — разрешено управление всеми кампаниями;

  • isCreateOwnCampaigns=1 — разрешено создание собственных кампаний;

  • isModifyOwnCampaigns=1 — разрешено управление приписанными к ассистенту кампаниями. Значение по умолчанию: 0.

isWebsite

Настройка прав доступа. Управление всеми сайтами.

Допустимые значения:

  • 1 — включить;
  • 0 — выключить. Значение по умолчанию: 0.

isCommonReports

Настройка прав доступа. Доступ к общим отчетам.

Допустимые значения:

  • 1 — включить;
  • 0 — выключить. Значение по умолчанию: 0.

* Обязательный параметр

Формат ответа

<response>
<status>
  <code>{integer}</code>
  <ID>{integer}</ID>
</status>
</response>

Параметры ответа

code

Статус обработки запроса. Значение 0 — запрос выполнен успешно. Расшифровку смотрите в разделе Обработка ошибок.

ID

Идентификатор объекта.

Пример запроса и ответа

Запрос:

https://adfox.yandex.ru/api/v1?object=account&action=add&actionObject=assistant

Ответ:

<response>
<status>
  <code>0</code>
  <ID>393747</ID>
</status>
</response>

Другие действия с объектом

Читайте также о других действиях с объектом assistant:

Предыдущая
Следующая