Lidar com uma resposta de relatório não é trivial, especialmente se você quiser que sua solução seja flexível e independente das dimensões e métricas reais escolhidas no relatório.
Felizmente, a resposta do relatório é bem completa e inclui muitas informações úteis.
Cabeçalhos
Você pode usar as informações retornadas nos cabeçalhos para escolher como formatar uma métrica específica. Ele inclui informações sobre o tipo de métrica, se é uma moeda, proporção ou contagem, por exemplo, e em qual moeda ela está, se for um valor monetário.
Exemplo:
"headers": [ { "name": "MONTH", "type": "DIMENSION" }, { "name": "CLICKS", "type": "METRIC_TALLY" }, { "name": "EARNINGS", "type": "METRIC_CURRENCY", "currency": "USD" }, { "name": "AD_REQUESTS_COVERAGE", "type": "METRIC_RATIO" } ]
Linhas
É aqui que você obtém os resultados reais do relatório. Cada linha de resposta representa uma linha de relatório, que tem um significado diferente com base nas dimensões escolhidas.
"rows": [
{ "cells":
[ {"value": "2021-01"}, {"value": "278"}, {"value": "63.12"}, {"value": "0.9998"} ],
[ {"value": "2021-02"}, {"value": "39"}, {"value": "8.46"}, {"value": "0.9998"} ]
}
]Totais e médias
Ao gerar um relatório, você também recebe as matrizes de utilitários totals e averages, que vão conter um valor para cada métrica apropriada.
"totals": {
"cells": [
{}, {"value": "317"}, {"value": "71.58"}, {"value": "0.9998"}
]
},
"averages": {
"cells": [
{}, {"value": "158"}, {"value": "71.58"}, {"value": "0.9998"}
]
}Datas de início e término
Se você usa datas relativas, pode ser útil saber quais são as datas de início e término calculadas.
"startDate": {"year": 2021, "month": 1, "day": 1},
"endDate": {"year": 2021, "month": 2, "day": 28}