Предоставление доступа

Выдает доступ к статистике определенному пользователю или агентству.

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

POST https://api.appmetrica.yandex.ru/management/v1/application/{id}/grants

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 POST \
  'https://api.appmetrica.yandex.ru/management/v1/application/1111/grants' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: OAuth 05dd3dd84ff948fdae2bc4fb91f13e22bb1f289ceef0037' \
  -d '{
  "grant": {
    "user_login": "user_login",
    "perm": "agency_view",
    "partners": [ 145375 ],
    "event_labels": ["Оформление покупки", "Переход в корзину"]
  }
}'
POST /management/v1/application/1111/grants 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 ],
    "event_labels": ["Оформление покупки", "Переход в корзину"]
  }
} 

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