Список разрешений

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

Request

GET

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

Path parameters

Name

Description

counterId

Type: integer

Идентификатор счетчика, для которого необходимо показать список разрешений.

Query parameters

Name

Description

callback

Type: string

Функция обратного вызова, которая обрабатывает ответ API.

Example: ``

Responses

200 OK

OK

Body

application/json
{
  "grants": [
    {
      "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

grants
Type: array
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.

Предыдущая
Создание операции
Следующая
Информация о разрешении