---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.1
alternate:
  - ru/
  - href: ru/index.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.ru/dev/ytm/ru/llms.txt

# Введение

API сервиса [Яндекс Тег Менеджер](https://yandex.ru/support/tag-manager/ru/) позволяет:

- Получать информацию о тегах.
- Получать информацию о триггерах.
- Получать информацию о переменных.
- Использовать шаблоны.

Для использования API Яндекс Тег Менеджера необходима [авторизация с помощью OAuth-токена](https://yandex.ru/dev/ytm/ru/intro/authorization.md). Авторизационный токен необходимо передавать в каждом запросе к API.

## Структура API {#structure}

API содержит следующие разделы:

- Просмотр тегов — позволяет получать список тегов и информацию о конкретных тегах.
- Просмотр триггеров — позволяет получать информацию о триггерах и условиях их срабатывания.
- Просмотр переменных — позволяет получать данные о переменных, используемых в тегах и триггерах.
- Использование шаблонов — позволяет получать список [публичных шаблонов](https://yandex.ru/support/tag-manager/ru/templates#tipy-shablonov) из галереи.

## Версионирование {#version}

Все разделы API Яндекс Тег Менеджера поддерживают версионирование. Каждая версия имеет уникальный идентификатор (например, `v1`, `v2` и т. д.). При выходе новой версии предыдущие продолжают работать для обеспечения обратной совместимости.

Рекомендации по использованию версий:

- Если вы только начинаете работу с API, используйте последнюю доступную версию.
- Если вы используете старую версию, постепенно переходите на новую, так как поддержка устаревших версий ограничена по времени.

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

Примеры запросов:

```httpget translate=no
https://api.ytm.yandex.net/ytm/management/v1/...
https://api.ytm.yandex.net/ytm/management/v2/...
```

## Ресурсы {#resource}

API Яндекс Тег Менеджера построен по принципам [REST](*REST).

Все сущности, доступные для получения информации через API, представлены в виде ресурсов: теги, триггеры, переменные и шаблоны. Каждый ресурс доступен для чтения через HTTP-метод `GET`.

У каждого ресурса есть свой уникальный URL. Все действия выполняются по протоколу HTTPS по адресу соответствующего ресурса.

Пример: для получения списка тегов отправьте GET-запрос на URL списка тегов.

## Узнайте больше {#learn-more}

- [Representational State Transfer (Wikipedia, english version)](http://en.wikipedia.org/wiki/Representational_State_Transfer)
- [REST (Википедия, русская версия)](http://ru.wikipedia.org/wiki/REST)

[*REST]: Representational State Transfer