Как сформировать отчет
Выполните запрос к сервису Reports.
В HTTP-заголовке Authorization укажите OAuth-токен, полученный для пользователя, по кампаниям которого требуется получить статистику. Полный список заголовков приведен в разделе HTTP-заголовки.
В теле запроса укажите значения основных параметров в зависимости от того, какие данные вам нужны:
за какой период требуется получить отчет и по каким периодам нужно агрегировать данные;
какой тип отчета подходит для вашей задачи;
какие поля (столбцы) необходимо выводить в отчете;
в каком виде следует выводить денежные значения;
какие фильтры будут использоваться для отбора данных.
Полный список входных параметров представлен в разделе Запрос: спецификация отчета.
Отчеты с небольшим количеством данных формируются в режиме онлайн. В этом случае вы сразу получите HTTP-код ответа 200, а отчет будет передан в теле ответа.
Отчеты с большим количеством данных, а также некоторые типы отчетов формируются в режиме офлайн. В этом случае вы получите HTTP-код ответа 201.
Подробная схема запросов и ответов приведена в разделе Онлайн- и офлайн-отчет.
Чтобы получить отчет, который формируется в режиме офлайн, повторите запрос с теми же параметрами через некоторое время.
Если формирование отчета еще не завершено, вы получите HTTP-код ответа 202.
Если отчет готов, вы получите HTTP-код ответа 200, а отчет будет передан в теле ответа.
Пример запроса и пример отчета представлен в разделе Пример: клики и стоимость.