La gestion des réponses à un rapport n'est pas simple, en particulier si vous souhaitez que votre solution soit flexible et indépendante des dimensions et métriques réelles que vous avez choisies dans votre rapport.
Heureusement, la réponse du 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. Il inclut des informations sur le type de métrique (devise, ratio ou décompte, par exemple), et la devise dans laquelle il s'agit (s'il s'agit d'une valeur 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 de 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}