إنّ التعامل مع الردود على التقارير ليس عملية بسيطة، خاصةً إذا كنت تريد أن يكون الحل الذي تقدّمه مرنًا ومستقلًا عن السمات والمقاييس الفعلية التي اخترتها في تقريرك.
لحسن الحظ، فإن الرد على التقرير مكتمل جدًا ويتضمن الكثير من المعلومات المفيدة.
العناوين
يمكنك استخدام المعلومات المعروضة في العناوين لاختيار كيفية تنسيق مقياس معيّن. وهو يشمل معلومات عن نوع المقياس، وما إذا كان عملة أو نسبة أو حصيلة على سبيل المثال، والعملة المستخدمة فيها، إذا كانت قيمة نقدية.
مثال:
"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}