處理報表回應並不容易,尤其如果您希望自己的解決方案能靈活且不受報表中選擇的實際維度和指標影響,更是如此。
幸好,報表回應相當完整,也包含許多實用資訊。
標頭
您可以使用標頭中傳回的資訊選擇特定指標的格式。其中包含指標的資訊,包括指標類型、是貨幣、比率或統計,以及貨幣價值 (如果為金額)。
範例:
"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}