Processar os resultados

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}

Próximas etapas