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}