Gestire le risposte a un report non è semplice, in particolare se vuoi che la tua soluzione sia flessibile e indipendente dalle dimensioni e dalle metriche effettive scelte nel report.
Per fortuna, la risposta al report è abbastanza completa e include molte informazioni utili.
Intestazioni
Puoi utilizzare le informazioni restituite nelle intestazioni per scegliere come formattare una determinata metrica. Include informazioni sul tipo di metrica, ad esempio se si tratta di una valuta, un rapporto o un conteggio e la valuta in cui si trova, se è un valore monetario.
Esempio:
"headers": [ { "name": "MONTH", "type": "DIMENSION" }, { "name": "CLICKS", "type": "METRIC_TALLY" }, { "name": "EARNINGS", "type": "METRIC_CURRENCY", "currency": "USD" }, { "name": "AD_REQUESTS_COVERAGE", "type": "METRIC_RATIO" } ]
Righe
Qui è dove si ottengono i risultati effettivi del report. Ogni riga di risposta rappresenta una riga del report, che ha un significato diverso in base alle dimensioni scelte.
"rows": [
{ "cells":
[ {"value": "2021-01"}, {"value": "278"}, {"value": "63.12"}, {"value": "0.9998"} ],
[ {"value": "2021-02"}, {"value": "39"}, {"value": "8.46"}, {"value": "0.9998"} ]
}
]Totali e medie
Quando esegui un report, ottieni anche gli array di utilità totals e averages, che conterranno un valore per ogni metrica appropriata.
"totals": {
"cells": [
{}, {"value": "317"}, {"value": "71.58"}, {"value": "0.9998"}
]
},
"averages": {
"cells": [
{}, {"value": "158"}, {"value": "71.58"}, {"value": "0.9998"}
]
}Date di inizio e di fine
Se utilizzi le date relative, a volte può essere utile sapere quali sono le date di inizio e di fine calcolate.
"startDate": {"year": 2021, "month": 1, "day": 1},
"endDate": {"year": 2021, "month": 2, "day": 28}