Обработка ответа на запрос отчета – непростая задача, особенно если вы хотите, чтобы ваше решение было гибким и не зависело от параметров и показателей, выбранных в отчете.
К счастью, ответ на отчет довольно полный и содержит много полезной информации.
заголовки;
Вы можете использовать информацию, возвращаемую в заголовках, чтобы выбрать способ форматирования определенного показателя. В частности, в нем указывается тип показателя (например, валюта, коэффициент или число), а также валюта, если это денежная ценность.
Пример
"headers": [ { "name": "MONTH", "type": "DIMENSION" }, { "name": "CLICKS", "type": "METRIC_TALLY" }, { "name": "EARNINGS", "type": "METRIC_CURRENCY", "currency": "USD" }, { "name": "AD_REQUESTS_COVERAGE", "type": "METRIC_RATIO" } ]
Строки
Здесь вы можете посмотреть результаты отчета. Каждая строка ответа представляет собой строку отчета, значение которой зависит от выбранных параметров.
"rows": [
{ "cells":
[ {"value": "2021-01"}, {"value": "278"}, {"value": "63.12"}, {"value": "0.9998"} ],
[ {"value": "2021-02"}, {"value": "39"}, {"value": "8.46"}, {"value": "0.9998"} ]
}
]Итоговые и средние значения
При создании отчета вы также получите массивы totals и averages, которые будут содержать значения для каждого показателя.
"totals": {
"cells": [
{}, {"value": "317"}, {"value": "71.58"}, {"value": "0.9998"}
]
},
"averages": {
"cells": [
{}, {"value": "158"}, {"value": "71.58"}, {"value": "0.9998"}
]
}Даты начала и окончания
Если вы используете относительные даты, иногда может быть полезно знать, какие даты начала и окончания были рассчитаны.
"startDate": {"year": 2021, "month": 1, "day": 1},
"endDate": {"year": 2021, "month": 2, "day": 28}