Obsługa odpowiedzi na raport nie jest łatwa, zwłaszcza jeśli chcesz, aby Twoje rozwiązanie było elastyczne i niezależne od wymiarów i danych wybranych w raporcie.
Na szczęście odpowiedź w raporcie jest dość wyczerpująca i zawiera dużo przydatnych informacji.
Nagłówki
Korzystając z informacji zwróconych w nagłówkach, możesz wybrać sposób formatowania konkretnych danych. Zawiera on informacje o typach danych, np. walucie, wskaźniku lub wyniku, a także o walucie (jeśli mają one wartość pieniężną).
Przykład:
"headers": [ { "name": "MONTH", "type": "DIMENSION" }, { "name": "CLICKS", "type": "METRIC_TALLY" }, { "name": "EARNINGS", "type": "METRIC_CURRENCY", "currency": "USD" }, { "name": "AD_REQUESTS_COVERAGE", "type": "METRIC_RATIO" } ]
Wiersze
Tutaj znajdziesz rzeczywiste wyniki raportu. Każdy wiersz odpowiedzi reprezentuje wiersz raportu, który ma inne znaczenie w zależności od wybranych wymiarów.
"rows": [
{ "cells":
[ {"value": "2021-01"}, {"value": "278"}, {"value": "63.12"}, {"value": "0.9998"} ],
[ {"value": "2021-02"}, {"value": "39"}, {"value": "8.46"}, {"value": "0.9998"} ]
}
]Sumy i średnie
Po uruchomieniu raportu otrzymasz również tablice narzędzi totals i averages, które zawierają wartości poszczególnych odpowiednich danych.
"totals": {
"cells": [
{}, {"value": "317"}, {"value": "71.58"}, {"value": "0.9998"}
]
},
"averages": {
"cells": [
{}, {"value": "158"}, {"value": "71.58"}, {"value": "0.9998"}
]
}Daty rozpoczęcia i zakończenia
Jeśli używasz dat względnych, warto znać obliczone daty rozpoczęcia i zakończenia.
"startDate": {"year": 2021, "month": 1, "day": 1},
"endDate": {"year": 2021, "month": 2, "day": 28}