Редактирование доступа

Изменяет ранее выданные права доступа.

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

PUT https://api.appmetrica.yandex.ru/management/v1/application/{id}/grant

id

Идентификатор приложения.

Тело запроса

{
  "grant": {
    "user_login": "string",
    "perm": "string",
    "partners": [ int, int ],
    "event_labels": ["string", "string"]
  }
}

user_login

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

perm

Уровень доступа.

Возможные значения:

  • view — права на чтение;
  • edit — права на чтение/редактирование;
  • agency_view — права на чтение для агентства;
  • agency_edit — права на чтение/редактирование для агентства.

Подробнее об уровнях доступа см. в разделе Управление доступом к приложению.

partners

Идентификаторы рекламных партнеров, для которых предоставляется доступ. Чтобы получить список всех партнеров, воспользуйтесь методом Список партнеров.

Обязательное поле при выдаче доступов agency_view и agency_edit.

Примечание

Если выдается агентский уровень доступа, необходимо указать хотя бы один идентификатор рекламного партнера.

event_labels

Целевые события, по которым агентства смогут просматривать статистику.

Дополнительное поле при выдаче доступов agency_view и agency_edit.

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

{
  "grant" : {
    "user_login" : "string",
    "user_uid" : int,
    "perm" : "string",
    "comment" : "string",
    "partners" : [ int, int ],
    "event_labels" : [ "string", "string" ]
  }

user_login

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

user_uid

Идентификатор пользователя, которому предоставляется доступ.

perm

Уровень доступа.

Возможные значения:

  • view — права на чтение;
  • edit — права на чтение/редактирование;
  • agency_view — права на чтение для агентства;
  • agency_edit — права на чтение/редактирование для агентства.

Подробнее о уровнях доступа в разделе Управление доступом.

comment

Комментарий.

partners

Идентификаторы рекламных партнеров, для которых предоставляется доступ. Чтобы получить список всех партнеров, воспользуйтесь методом Список партнеров.

event_labels

Целевые события, по которым агентства смогут просматривать статистику.

Пример

curl -X PUT \
  'https://api.appmetrica.yandex.ru/management/v1/application/1111/grant' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: OAuth <your_token>' \
  -d '{
  "grant": {
    "user_login": "user_login",
    "perm": "agency_view",
    "partners": [ 145375, 148711 ],
    "event_labels": ["Оформление покупки", "Переход в корзину"]
  }
}'

где <your_token> — это OAuth-токен, который можно получить по инструкции.

PUT /management/v1/application/1111/grant HTTP/1.1
Host: api.appmetrica.yandex.ru
Content-Type: application/json
Authorization: OAuth <your_token>

{
  "grant": {
    "user_login": "user_login",
    "perm": "agency_view",
    "partners": [ 145375, 148711 ],
    "event_labels": ["Оформление покупки", "Переход в корзину"]
  }
}

где <your_token> — это OAuth-токен, который можно получить по инструкции.

Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.

Написать в службу поддержки
Предыдущая
Предоставление доступа
Следующая
Список партнеров