Gestire una risposta a un report non è banale, in particolare se vuoi che la tua soluzione sia flessibile e indipendente dalle dimensioni e dalle metriche effettive scelte nel report.
Fortunatamente, la risposta al report è piuttosto completa e include molte informazioni utili.
Intestazioni
Puoi utilizzare le informazioni restituite nelle intestazioni per scegliere come formattare una metrica specifica. Include informazioni sul tipo di metrica, ad esempio se si tratta di una valuta, un rapporto o un conteggio, e la valuta utilizzata, se si tratta di 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 che vengono visualizzati 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 contengono 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 fine
Se utilizzi le date relative, a volte potrebbe 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}