---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.3
alternate:
  - ru/
  - href: https://yandex.ru/dev/admetrica/doc/ru/index.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/dev/admetrica/doc/ru/llms.txt?revision=r20856727
    rel: describedby
title: API Метрики для медийной рекламы
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/admetrica/doc/ru/llms.txt?revision=r20856727


# Введение

В документе описаны основные ресурсы, которыми можно управлять через API Метрики для медийной рекламы.

API сервиса позволяют:

- Управлять кампаниями, не используя веб-интерфейс.

- Получать статистику кампаний (количество показов, достижений целей и др.).

- Формировать отчеты, в том числе с помощью сегментации.

Для использования API Метрики для медийной рекламы необходима авторизация с помощью OAuth-токена.

## Структура API

API включает в себя следующие разделы:

- API управления — позволяет управлять кампаниями, целями и другими объектами API Метрики для медийной рекламы.

- API отчетов — позволяет формировать сводки по кампаниям, создавать отчеты, поддерживает полный набор группировок и метрик, сравнение сегментов и т. п. Доступно в рамках [Метрики Про](https://yandex.ru/support/metrica/pro/intro.html).

## Ресурсы

API Метрики для медийной рекламы построен по REST-принципам.

Все, чем можно управлять через API, представлено в виде ресурсов: статистика, список кампаний, цели кампаний и каждая конкретная цель, доступы к кампании и т. д.

То есть ресурс — это некая целостная часть системы, с которой можно работать:

- читать содержимое и текущее состояние ресурса (GET);

- изменять содержимое и состояние и записывать его в ресурс (PUT);

- удалять ресурс (DELETE);

- выполнять специальные действия ― например, добавлять новые элементы в список (POST).

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

### Узнайте больше

- [Representational State Transfer (Wikipedia, english version)](https://en.wikipedia.org/wiki/Representational_state_transfer)

- [REST (Википедия, русская версия)](https://ru.wikipedia.org/wiki/REST)