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

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

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

  • 0 — выключено;
  • 1 — включено.

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

isAdvertisers

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

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

  • 0 — выключено;
  • 1 — включено.

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

isModifyAllCampaigns

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

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

  • 0 — выключено;
  • 1 — включено.

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

isModifyOwnCampaigns

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

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

  • 0 — выключено;
  • 1 — включено.

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

Включается автоматически, если:

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

isViewAllCampaigns

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

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

  • 0 — выключено;
  • 1 — включено.

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

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

isViewOwnCampaigns

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

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

  • 0 — выключено;
  • 1 — включено.

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

Включается автоматически, если:

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

isWebsite

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

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

  • 0 — выключено;
  • 1 — включено.

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

isCommonReports

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

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

  • 0 — выключено;
  • 1 — включено.

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

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

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

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

code

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

ID

ID объекта.

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

Запрос:

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

Ответ:

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

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

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

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

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

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

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

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

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

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

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

  • 0 — выключено;
  • 1 — включено.

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

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

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

  • 0 — выключено;
  • 1 — включено.

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

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

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

  • 0 — выключено;
  • 1 — включено.

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

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

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

  • 0 — выключено;
  • 1 — включено.

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

Включается автоматически, если:

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

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

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

  • 0 — выключено;
  • 1 — включено.

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

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

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

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

  • 0 — выключено;
  • 1 — включено.

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

Включается автоматически, если:

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

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

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

  • 0 — выключено;
  • 1 — включено.

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

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

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

  • 0 — выключено;
  • 1 — включено.

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

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

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