보고서 응답을 처리하는 것은 간단하지 않습니다. 특히 보고서에서 선택한 실제 측정기준 및 측정항목에 대해 유연하고 독립적인 솔루션을 원하는 경우 더욱 그렇습니다.
다행히 보고서 응답은 꽤 완전하며 유용한 정보를 많이 포함하고 있습니다.
헤더
헤더에 반환된 정보를 사용하여 특정 측정항목의 형식을 지정하는 방법을 선택할 수 있습니다. 여기에는 측정항목의 유형(예: 통화, 비율 또는 집계)과 측정항목이 금전적 가치일 경우 통화의 사용 내역에 관한 정보가 포함됩니다.
예:
"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}