Maneja los resultados

Administrar las respuestas de un informe no es trivial, en especial si quieres que tu solución sea independiente de las dimensiones y métricas reales que elijas en tu informe.

Afortunadamente, la respuesta del informe es bastante completa e incluye mucha información útil.

Encabezados

Puedes usar la información que se muestra en los encabezados para elegir cómo darle formato a una métrica en particular. Incluye información sobre el tipo de métrica, si es una moneda, una proporción o un recuento, y en qué moneda se utiliza, si es un valor monetario.

Ejemplo:

"headers": [
  { "name": "MONTH", "type": "DIMENSION" },
  { "name": "CLICKS", "type": "METRIC_TALLY" },
  { "name": "EARNINGS", "type": "METRIC_CURRENCY", "currency": "USD" },
  { "name": "AD_REQUESTS_COVERAGE", "type": "METRIC_RATIO" }
]

Filas

Aquí es donde verás los resultados reales del informe. Cada fila de respuesta representa una fila de informe, que tiene un significado diferente según las dimensiones que hayas elegido.

"rows": [
  { "cells":
    [ {"value": "2021-01"}, {"value": "278"}, {"value": "63.12"}, {"value": "0.9998"} ],
    [ {"value": "2021-02"}, {"value": "39"}, {"value": "8.46"}, {"value": "0.9998"} ]
  }
]

Totales y promedios

Cuando ejecutas un informe, también obtienes los arrays de utilidades totals y averages, que contendrán un valor para cada métrica adecuada.

"totals": {
  "cells": [
    {}, {"value": "317"}, {"value": "71.58"}, {"value": "0.9998"}
  ]
},
"averages": {
  "cells": [
    {}, {"value": "158"}, {"value": "71.58"}, {"value": "0.9998"}
  ]
}

Fechas de inicio y finalización

Si utilizas fechas relativas, a veces puede resultar útil conocer las fechas de inicio y finalización calculadas.

"startDate": {"year": 2021, "month": 1, "day": 1},
"endDate": {"year": 2021, "month": 2, "day": 28}

Próximos pasos