Maneja los resultados

Manejar la respuesta de un informe no es trivial, en especial si deseas que tu solución sea flexible e independiente de las dimensiones y métricas reales que elegiste en el informe.

Por suerte, 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 dar 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, por ejemplo, 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 puede obtener los resultados reales del informe. Cada fila de respuesta representa una fila de informe, que tiene un significado diferente según las dimensiones que elegiste.

"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 correspondiente.

"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 ser útil saber cuáles son 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