Das Verarbeiten einer Berichtantwort ist nicht einfach, insbesondere wenn Ihre Lösung flexibel und unabhängig von den im Bericht ausgewählten Dimensionen und Messwerten sein soll.
Glücklicherweise ist die Antwort auf den Bericht ziemlich vollständig und enthält viele nützliche Informationen.
Header
Anhand der Informationen, die in den Headern zurückgegeben werden, können Sie auswählen, wie ein bestimmter Messwert formatiert werden soll. Er enthält Informationen darüber, um welchen Messwert es sich handelt, ob es sich beispielsweise um eine Währung, ein Verhältnis oder eine Zählung handelt und um welche Währung es sich handelt, wenn 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 eigentlichen Berichtsergebnisse. 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 Durchschnitte
Wenn Sie einen Bericht erstellen, werden auch die Dienstprogramm-Arrays totals
und averages
zurückgegeben, die einen Wert für jeden entsprechenden 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 hilfreich sein, die berechneten Start- und Enddaten zu kennen.
"startDate": {"year": 2021, "month": 1, "day": 1}, "endDate": {"year": 2021, "month": 2, "day": 28}