---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/metrika/en/data-import/manage-protocol.md
  - https://yandex.com/dev/metrika/ru/data-import/manage-protocol.md
  - href: ru/data-import/manage-protocol.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/metrika/ru/llms.txt

# Управление опцией и токенами

## Включение опции через API {#enable-option}

```http translate=no
curl -X PUT 'https://api-metrika.yandex.net/management/v1/counter/<counter_id>?field=counter_flags'
-H 'accept: application/json'
-H 'Authorization: OAuth <access_token>'
-H 'Content-Type: application/json'
-d '{
      "counter": {
        "counter_flags": {
          "measurement_enabled": true
        }
      }
    }'
```

## Проверка включения флага {#check-flag}

Чтобы проверить, включена ли фича, отправьте запрос:

```http translate=no
curl -X GET 'https://api-metrika.yandex.net/management/v1/counter/<counter_id>?field=counter_flags'
-H 'Authorization: OAuth <access_token>'
```

Ответ будет содержать флаг включения (параметр `measurement_enabled`):

```json translate=no
{
  "counter": {
    // ...
    "counter_flags": {
      "counter_id": <counter_id>,
      "use_in_benchmarks": true,
      "direct_allow_use_goals_without_access": true,
      "incognito": "disabled",
      "collect_first_party_data": true,
      "news_enabled_by_user": true,
      "news_enabled_by_classifier": true,
      "measurement_enabled": true
    },
  //...
  }
}
```

## Получение активных токенов {#get-tokens}

{% note info %}

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

{% endnote %}

**Запрос**

```http translate=no
curl -X GET 'https://api-metrika.yandex.net/management/v1/counter/{counter_id}?field=measurement_tokens'
-H 'Authorization: OAuth <access_token>'
```

**Ответ**

```json translate=no
{
  "counter": {
    // ...
    "measurement_tokens": [
      "196aXXXX-ebe0-XddX-XxDD-bXXXX7XXXX50",
      "XXX25XX4-XxDD-XXXX-a000-XXXXe3a4XXXX",
      "52cDDd3c-XXXX-4cef-XxDD-1709bXXXXa5a",
      "XXXXb007-XxDD-4700-9002-XXXX0eae000b"
    ]
  // ...
  }
}
```

## Генерация дополнительных токенов {#gen-tokens}

Дополнительные токены можно сгенерировать с помощью запроса:

```http translate=no
curl -X GET 'https://api-metrika.yandex.net/management/v1/counter/{counterId}/measurement/generate'
-H 'Authorization: OAuth <access_token>'
```

В ответ вы получите новый токен:

```json translate=no
{
  "response": "XXXXb007-XxDD-4700-9002-XXXX0eae000b"
}
```

{% note warning %}

Максимальное количество активных токенов на счетчик — 5. Если попробовать сгенерировать больше, вы получите ответ `400`:

```json translate=no
{
  "errors": [
    {
      "error_type": "invalid_parameter",
      "message": "the limit of active tokens for the following counters has been reached: [counter_id]"
    }
  ],
  "code": 400,
  "message": "the limit of active tokens for the following counters has been reached: [counter_id]"
}
```

{% endnote %}

## Удаление токена {#delete-token}

Удалить токен можно с помощью запроса:

```http translate=no
curl -X POST 'https://api-metrika.yandex.net/management/v1/counter/{counterId}/measurement/delete?token={token}'
-H 'Authorization: OAuth <access_token>'
```

{% note info %}

Все полученные токены необходимо указывать в параметре `ms` (Measurement Secret) во время [отправки данных](https://yandex.com/dev/metrika/ru/data-import/measurement-upload.md).

{% endnote %}