---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://appmetrica.yandex.by/docs/en/mobile-api/management/applications/access/grant.md
  - https://appmetrica.yandex.by/docs/ru/mobile-api/management/applications/access/grant.md
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.by/docs/ru/llms.txt

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

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

## Формат запроса {#request-format}

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

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

### Тело запроса {#request-body}

```json translate=no
{
  "grant": {
    "user_login": "string",
    "perm": "string",
    "partners": [ int, int ],
    "event_labels": ["string", "string"]
  }
}
```
#|
|| `user_login` | Адрес электронной почты на Яндексе (логин) пользователя, которому предоставляется доступ. ||
|| `perm` | Уровень доступа.

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

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

Подробнее об уровнях доступа см. в разделе [Управление доступом](https://appmetrica.yandex.by/docs/ru/common/access.md).
||
|| `partners` | Идентификаторы рекламных партнеров, для которых предоставляется доступ. Чтобы получить список всех партнеров, воспользуйтесь методом [Список партнеров](https://appmetrica.yandex.by/docs/ru/mobile-api/management/applications/access/list-partners.md).

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

{% note info %}

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

{% endnote %}

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

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

||
|#

## Формат ответа {#response-body}

```json translate=no
{
  "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` — права на чтение/редактирование для агентства.

Подробнее о уровнях доступа в разделе [Управление доступом](https://appmetrica.yandex.by/docs/ru/common/access.md). ||
|| `comment` | Комментарий. ||
|| `partners` | Идентификаторы рекламных партнеров, для которых предоставляется доступ. Чтобы получить список всех партнеров, воспользуйтесь методом [Список партнеров](https://appmetrica.yandex.by/docs/ru/mobile-api/management/applications/access/list-partners.md). ||
|| `event_labels` | Целевые события, по которым агентства смогут просматривать статистику. ||
|#

## Пример {#example}

{% list tabs %}

- cURL

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

  где `<your_token>` — это OAuth-токен, который можно получить по [инструкции](https://appmetrica.yandex.by/docs/ru/mobile-api/intro/authorization.md#get-oauth-token).

- HTTP

  ```http translate=no
  POST /management/v1/application/1111/grants 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 ],
      "event_labels": ["Оформление покупки", "Переход в корзину"]
    }
  } 
  ```

  где `<your_token>` — это OAuth-токен, который можно получить по [инструкции](https://appmetrica.yandex.by/docs/ru/mobile-api/intro/authorization.md#get-oauth-token).

{% endlist %}

<!-- source: ru/_includes/feedback-button-4.md -->
Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.

<a href="../../../../troubleshooting/feedback-new">
  <span class="button">Написать в службу поддержки</span>
</a>

<a href="../../../../troubleshooting/feedback-docs">
  <span class="button">Предложить улучшение для документации</span>
</a>
<!-- endsource: ru/_includes/feedback-button-4.md -->