Gérer les réponses à un rapport n'est pas une mince affaire, en particulier si vous souhaitez que votre solution soit flexible et indépendante des dimensions et métriques réelles sélectionnées dans votre rapport.
Heureusement, la réponse au rapport est assez complète et comprend de nombreuses informations utiles.
En-têtes
Vous pouvez utiliser les informations renvoyées dans les en-têtes pour choisir la mise en forme d'une métrique spécifique. Elles incluent des informations sur le type de métrique, qu'il s'agisse d'une devise, d'un ratio ou d'un décompte, par exemple, ainsi que sur la devise dans laquelle elle est utilisée (si la valeur est monétaire).
Exemple :
"headers": [ { "name": "MONTH", "type": "DIMENSION" }, { "name": "CLICKS", "type": "METRIC_TALLY" }, { "name": "EARNINGS", "type": "METRIC_CURRENCY", "currency": "USD" }, { "name": "AD_REQUESTS_COVERAGE", "type": "METRIC_RATIO" } ]
Lignes
C'est ici que vous obtenez les résultats réels du rapport. Chaque ligne de réponse représente une ligne du rapport, qui a une signification différente en fonction des dimensions que vous avez choisies.
"rows": [
{ "cells":
[ {"value": "2021-01"}, {"value": "278"}, {"value": "63.12"}, {"value": "0.9998"} ],
[ {"value": "2021-02"}, {"value": "39"}, {"value": "8.46"}, {"value": "0.9998"} ]
}
]Totaux et moyennes
Lorsque vous générez un rapport, vous obtenez également les tableaux utilitaires totals et averages, qui contiennent une valeur pour chaque métrique appropriée.
"totals": {
"cells": [
{}, {"value": "317"}, {"value": "71.58"}, {"value": "0.9998"}
]
},
"averages": {
"cells": [
{}, {"value": "158"}, {"value": "71.58"}, {"value": "0.9998"}
]
}Dates de début et de fin
Si vous utilisez des dates relatives, il peut parfois être utile de connaître les dates de début et de fin calculées.
"startDate": {"year": 2021, "month": 1, "day": 1},
"endDate": {"year": 2021, "month": 2, "day": 28}