הטיפול בתשובה לדוח אינו טריוויאלי, במיוחד אם אתם רוצים שהפתרון יהיה גמיש ובלתי תלוי במאפיינים ובמדדים שבחרתם בדוח.
למרבה המזל, התגובה לדיווח מלאה למדי וכוללת מידע שימושי.
כותרות
אפשר להשתמש במידע שמוצג בכותרות כדי לבחור איך לעצב מדד מסוים. הוא כולל מידע על סוג המדד, למשל מטבע, יחס או ספירה, ואת המטבע שבו הוא מוגדר, אם מדובר בערך כספי.
לדוגמה:
"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}