处理结果

对报告响应的处理并非易事，尤其是当您希望自己的解决方案足够灵活，且独立于您在报告中选择的实际维度和指标时。

幸运的是，报告响应相当完整，并且包含大量有用信息。

标头

您可以使用标头中返回的信息来选择如何为特定指标设置格式。其中包括指标类型、指标类型（例如货币、比率或计数）以及所用币种（如果指标为货币价值）的信息。

示例： 

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

行

您可以在此处获得实际的报告结果。每个响应行代表一个报告行，根据您选择的维度，该行具有不同的含义。

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

总计和平均值

生成报告时，您还会返回 totals 和 averages 实用程序数组，其中包含每个相应指标的值。

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

开始日期和结束日期

如果您使用的是相对日期，则有时了解所计算的开始日期和结束日期会很有用。

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

后续步骤