Создание публичного разрешения

Создает разрешение на публичный просмотр статистики.

Request

POST

https://api-metrika.yandex.net/management/v1/counter/{counterId}/public_grant

Path parameters

Name

Description

counterId

Type: integer

Идентификатор счетчика, для которого вы хотите создать разрешение.

Responses

200 OK

OK

Body

application/json
{
  "grant": {
    "user_login": "example",
    "user_uid": 0,
    "perm": "example",
    "created_at": "2025-01-01T00:00:00Z",
    "comment": "example",
    "email": "example",
    "partner_data_access": true
  }
}

Name

Description

grant

One of 2 types
  • Type: CounterGrantE

    Список структур с информацией о правах доступа к счетчику.

    Example
    {
      "user_login": "example",
      "user_uid": 0,
      "perm": "example",
      "created_at": "2025-01-01T00:00:00Z",
      "comment": "example",
      "email": "example",
      "partner_data_access": true
    }
    
  • Type: AccessFiltersGrantE

    Example
    {
      "user_login": "example",
      "user_uid": 0,
      "perm": "example",
      "created_at": "2025-01-01T00:00:00Z",
      "comment": "example",
      "email": "example",
      "partner_data_access": true,
      "access_filters": [
        {
          "id": 0,
          "name": "example"
        }
      ]
    }
    
Example
{
  "user_login": "example",
  "user_uid": 0,
  "perm": "example",
  "created_at": "2025-01-01T00:00:00Z",
  "comment": "example",
  "email": "example",
  "partner_data_access": true
}

CounterGrantE

Список структур с информацией о правах доступа к счетчику.

Name

Description

perm

Type: string

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

  • public_stat — публичный доступ к статистике.
  • view — только просмотр.
  • edit — полный доступ.
  • analyst — аналитик.
  • analyst_access_filter — аналитик данных через фильтр.

Example: example

comment

Type: string

Произвольный комментарий. Количество символов не должно превышать 255.

Min length: 0

Max length: 255

Example: example

created_at

Type: string<date-time>

Дата предоставления доступа в формате YYYY-MM-DD'T'hh:mm:ssZ.

Example: 2025-01-01T00:00:00Z

partner_data_access

Type: boolean

Доступ к группе отчетов «Монетизация». Пользователь сможет просматривать отчеты, добавлять группировки и метрики из группы «Монетизация» в другие отчеты. Если у пользователя есть доступ на редактирование, то ему уже доступны отчеты группы «Монетизация». Возможные значения:

  • true — доступ разрешен;
  • false — доступ не разрешен.

user_login

Type: string

Логин пользователя, которому выдано разрешение на управление счетчиком. Параметр содержит пустую строку, если к статистике счетчика предоставлен публичный доступ (perm = public_stat).

Example: example

Example
{
  "user_login": "example",
  "perm": "example",
  "created_at": "2025-01-01T00:00:00Z",
  "comment": "example",
  "partner_data_access": true
}

AccessFiltersShortE

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

Name

Description

id

Type: integer

id фильтра доступа.

name

Type: string

Название фильтра доступа.

Example: example

Example
{
  "id": 0,
  "name": "example"
}

AccessFiltersGrantE

All of 2 types
  • Type: CounterGrantE

    Список структур с информацией о правах доступа к счетчику.

    Example
    {
      "user_login": "example",
      "user_uid": 0,
      "perm": "example",
      "created_at": "2025-01-01T00:00:00Z",
      "comment": "example",
      "email": "example",
      "partner_data_access": true
    }
    
  • Type: object

    access_filters

    Type: AccessFiltersShortE[]

    Min items: 1

    Max items: 1

    Example
    [
      {
        "id": 0,
        "name": "example"
      }
    ]
    
    Example
    {
      "access_filters": [
        {
          "id": 0,
          "name": "example"
        }
      ]
    }
    
Example
{
  "user_login": "example",
  "user_uid": 0,
  "perm": "example",
  "created_at": "2025-01-01T00:00:00Z",
  "comment": "example",
  "email": "example",
  "partner_data_access": true,
  "access_filters": [
    {
      "id": 0,
      "name": "example"
    }
  ]
}

No longer supported, please use an alternative and newer version.