Uzyskanie odpowiedzi w raporcie nie jest proste, zwłaszcza jeśli chcesz, aby Twoje rozwiązanie było elastyczne oraz niezależne od wymiarów i danych wybranych w raporcie.
Na szczęście odpowiedź w raporcie jest kompletna i zawiera wiele przydatnych informacji.
nagłówków,
Korzystając z informacji zwróconych w nagłówkach, możesz wybrać sposób formatowania poszczególnych danych. Zawierają informacje o typie danych, np. walucie, współczynniku lub zestawieniu oraz w jakiej walucie (jeśli jest to wartość pieniężna).
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 odpowiada wierszowi 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 wygenerowaniu raportu otrzymujesz też tablice narzędziowe totals i averages, które zawierają wartości 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, przydatne może być informacje o obliczonych datach rozpoczęcia i zakończenia.
"startDate": {"year": 2021, "month": 1, "day": 1},
"endDate": {"year": 2021, "month": 2, "day": 28}