Menangani respons laporan tidaklah mudah, terutama jika Anda ingin solusi Anda fleksibel dan independen dari dimensi dan metrik aktual yang Anda pilih dalam laporan.
Untungnya, respons laporannya cukup lengkap dan menyertakan banyak informasi yang berguna.
Header
Anda dapat menggunakan informasi yang ditampilkan di header untuk memilih cara memformat metrik tertentu. Laporan ini mencakup informasi tentang jenis metriknya, misalnya apakah itu mata uang, rasio atau kalkulasi, dan mata uang yang digunakan, jika berupa nilai uang.
Contoh:
"headers": [ { "name": "MONTH", "type": "DIMENSION" }, { "name": "CLICKS", "type": "METRIC_TALLY" }, { "name": "EARNINGS", "type": "METRIC_CURRENCY", "currency": "USD" }, { "name": "AD_REQUESTS_COVERAGE", "type": "METRIC_RATIO" } ]
Baris
Di sinilah Anda mendapatkan hasil laporan yang sebenarnya. Setiap baris respons mewakili baris laporan, yang memiliki arti berbeda berdasarkan dimensi yang Anda pilih.
"rows": [
{ "cells":
[ {"value": "2021-01"}, {"value": "278"}, {"value": "63.12"}, {"value": "0.9998"} ],
[ {"value": "2021-02"}, {"value": "39"}, {"value": "8.46"}, {"value": "0.9998"} ]
}
]Total dan rata-rata
Saat menjalankan laporan, Anda juga mendapatkan kembali array utilitas totals dan averages, yang akan berisi nilai untuk setiap metrik yang sesuai.
"totals": {
"cells": [
{}, {"value": "317"}, {"value": "71.58"}, {"value": "0.9998"}
]
},
"averages": {
"cells": [
{}, {"value": "158"}, {"value": "71.58"}, {"value": "0.9998"}
]
}Tanggal Mulai dan Akhir
Jika Anda menggunakan tanggal relatif, terkadang berguna untuk mengetahui tanggal mulai dan akhir yang dihitung.
"startDate": {"year": 2021, "month": 1, "day": 1},
"endDate": {"year": 2021, "month": 2, "day": 28}