---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://boost.yandex.com/doc/en/analytics/content/mobile-api/management/applications/access/edit.md
  - https://boost.yandex.com/doc/ru/analytics/content/mobile-api/management/applications/access/edit.md
  - https://boost.yandex.com/doc/zh/analytics/content/mobile-api/management/applications/access/edit.md
  - href: https://boost.yandex.com/doc/zh/analytics/content/mobile-api/management/applications/access/edit.md
    type: text/markdown
    title: Markdown version
  - href: https://boost.yandex.com/doc/zh/llms.txt?revision=r21738064
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/zh/llms.txt?revision=r21738064

# 编辑权限

修改之前授予的访问权限。

## 请求格式 {#request-format}

```
更新 https://api.boost.yandex.com/management/v1/application/{id}/grant
```
#|
|| `id` | App ID ||
|#

### Request body {#request-body}

```json translate=no
{
  "grant": {
    "user_login": "string",
    "perm": "string",
    "partners": [ int, int ],
    "event_labels": ["string", "string"]
  }
}
```
#|
|| `用户登录` | 被授予访问权限的用户的 Yandex 电子邮件地址（登录名） ||
|| `perm` | 访问级别。

可能的值：

- `查看`：只读。
- `编辑`：读取/编辑。
- `代理视图`：仅允许代理查看。
- `agency_edit`: 代理商查看/编辑。

要了解有关访问级别的更多信息，请参见[访问分析功能](https://boost.yandex.com/doc/zh/analytics/content/common/access.md)。
||
|| `伙伴` | 拥有访问权限的广告合作伙伴的ID。 要获取所有伙伴的列表，请使用[Partner list](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/management/applications/access/list-partners.md)方法。

这是授予 `agency_view` 和 `agency_edit` 权限时必填的字段。

{% note info %}

如果您正在授予代理级别的访问权限，请务必指定至少一个广告合作伴 ID。

{% 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" ]
  }
```
#|
|| `用户登录` | Yandex 邮箱地址（登录名）——被授予访问权限的用户。 ||
|| `uid` | 被授权访问的用户ID。 ||
|| `perm` | 访问级别。

可能的值：

- `查看`：只读。
- `编辑`：读取/编辑。
- `代理视图`：仅允许代理查看。
- `agency_edit`: 代理商查看/编辑。

要了解有关访问级别的更多信息，请查看[管理应用访问](https://boost.yandex.com/doc/zh/analytics/content/common/access.md)。 ||
|| `comment` | 一条评论。 ||
|| `伙伴` | 广告合作伙伴的ID，已被授权访问。 要获取所有合作伙伴的列表，请使用[Partner list](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/management/applications/access/list-partners.md)方法。 ||
|| `event_labels` | 目标事件，代理商可以查看其统计数据。 ||
|#

## Example {#example}

{% list tabs %}

- cURL

   ```bash translate=no
   curl -X PUT \
     'https://api.boost.yandex.com/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": ["Checkout", "Proceed to cart"]
     }
   }'
   ```

   where `<your_token>` 是一个 OAuth 令牌，可以通过 [说明](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/intro/authorization.md#get-oauth-token) 获取。

- HTTP

   ```http translate=no
   PUT /management/v1/application/1111/grant HTTP/1.1
   Host: api.boost.yandex.com
   Content-Type: application/json
   Authorization: OAuth <your_token>

   {
     "grant": {
       "user_login": "user_login",
       "perm": "agency_view",
       "partners": [ 145375, 148711 ],
       "event_labels": ["Checkout", "Proceed to cart"]
     }
   }
   ```

   其中 `<your_token>` 是一个 OAuth 令牌，可以通过 [说明](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/intro/authorization.md#get-oauth-token) 获取。

{% endlist %}

<!-- source: zh/analytics/content/_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: zh/analytics/content/_includes/feedback-button-4.md -->