assistant

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

  1. Формат запроса
  2. Формат ответа
  3. Параметры ответа
  4. Другие действия с объектом

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

https://api.adfox.ru/v1/API.php
 ? loginAccount=<string>
 & loginPassword=<string>
 & object=account
 & action=add
 & actionObject=assistant
 & account=<string>
 & password=<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>]
Query-параметры
account *

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

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

password *

Необходимо создать пароль для доступа пользователя, получить от пароля хеш-функцию sha256 и передать в значении параметра.

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

Статус обработки запроса. Расшифровку смотрите в разделе Обработка ошибок.

ID

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

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

Запрос:

https://api.adfox.ru/v1/API.php?loginAccount={your_login}&loginPassword={sha256_your_password}&object=account&action=add&actionObject=assistant&account=логин_ассистента&password=sha256_от_пароля_для_аккаунта_ассистента&eMail=pochta@yandex.ru

Ответ:

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

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

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