Die Verarbeitung einer Berichtsantwort ist nicht ganz einfach, insbesondere wenn Sie möchten, dass Ihre Lösung flexibel und unabhängig von den Dimensionen und Messwerten ist, die Sie in Ihrem Bericht auswählen.
Glücklicherweise ist die Antwort auf den Bericht ziemlich vollständig und enthält viele nützliche Informationen.
Header
Sie können die in den Headern zurückgegebenen Informationen verwenden, um auszuwählen, wie ein bestimmter Messwert formatiert werden soll. Sie enthält Informationen dazu, um welchen Messwerttyp es sich handelt, ob es sich beispielsweise um eine Währung, um ein Verhältnis oder um eine Zahl handelt, und um die Währung, falls es sich um einen Geldwert handelt.
Beispiel:
"headers": [ { "name": "MONTH", "type": "DIMENSION" }, { "name": "CLICKS", "type": "METRIC_TALLY" }, { "name": "EARNINGS", "type": "METRIC_CURRENCY", "currency": "USD" }, { "name": "AD_REQUESTS_COVERAGE", "type": "METRIC_RATIO" } ]
Zeilen
Hier erhalten Sie die tatsächlichen Berichtergebnisse. Jede Antwortzeile steht für eine Berichtszeile, die je nach den von Ihnen ausgewählten Dimensionen eine andere Bedeutung hat.
"rows": [
{ "cells":
[ {"value": "2021-01"}, {"value": "278"}, {"value": "63.12"}, {"value": "0.9998"} ],
[ {"value": "2021-02"}, {"value": "39"}, {"value": "8.46"}, {"value": "0.9998"} ]
}
]Summen und Durchschnittswerte
Wenn Sie einen Bericht erstellen, werden auch die Dienstprogramm-Arrays totals und averages zurückgegeben, die einen Wert für den jeweiligen Messwert enthalten.
"totals": {
"cells": [
{}, {"value": "317"}, {"value": "71.58"}, {"value": "0.9998"}
]
},
"averages": {
"cells": [
{}, {"value": "158"}, {"value": "71.58"}, {"value": "0.9998"}
]
}Start- und Enddatum
Wenn Sie relative Daten verwenden, kann es manchmal nützlich sein, das berechnete Start- und Enddatum zu kennen.
"startDate": {"year": 2021, "month": 1, "day": 1},
"endDate": {"year": 2021, "month": 2, "day": 28}