modify

Редактировать параметры пользователя с типом «ассистент».

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

https://adfox.yandex.ru/api/v1
  ? object=assistant
  & action=modify
  & objectID=<integer>
  & [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>]

objectID*

ID объекта, над которым производится действие.

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>
</status>
</response>

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

code

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

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

Запрос:

https://adfox.yandex.ru/api/v1?object=assistant&action=modify&objectID=543&company=84993334455

Ответ:

<response>
<status>
  <code>0</code>
</status>
</response>

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

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

ID объекта, над которым производится действие.

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

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

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

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

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

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

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

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

  • 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.

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

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