Menangani respons laporan tidaklah mudah, terutama jika Anda menginginkan solusi yang fleksibel dan tidak bergantung pada dimensi dan metrik sebenarnya yang Anda pilih dalam laporan.
Untungnya, respons laporan tersebut cukup lengkap dan menyertakan banyak informasi yang berguna.
Header
Anda dapat menggunakan informasi yang ditampilkan di header untuk memilih cara memformat metrik tertentu. Hal ini mencakup informasi tentang jenis metrik, misalnya mata uang, rasio atau penghitungan, dan mata uang yang digunakan, jika berupa nilai moneter.
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 sini Anda akan 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 akan 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 ada baiknya untuk mengetahui tanggal mulai dan tanggal akhir yang dihitung.
"startDate": {"year": 2021, "month": 1, "day": 1}, "endDate": {"year": 2021, "month": 2, "day": 28}