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

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

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

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 05dd3dd84ff948fdae2bc4fb91f13e22bb1f289ceef0037' \
  -d '{
  "grant": {
    "user_login": "user_login",
    "perm": "agency_view",
    "partners": [ 145375, 148711 ],
    "event_labels": ["Оформление покупки", "Переход в корзину"]
  }
}'

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

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

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

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