상대적인 날짜 키워드 사용

편의를 위해 startDateendDate 매개변수에서 표준 형식 YYYY-MM-DD 대신에 다음과 같은 특수 키워드가 사용됩니다.

  • today
  • startOfMonth
  • startOfYear
  • latest

이 키워드를 이용하면 현재 날짜를 기준으로 상대적인 실적을 보고서로 조회할 수 있습니다. 또한 이들 키워드는 다음과 같이 수정할 수도 있습니다.

보고서시작일종료일
최근 7일의 실적today-6dtoday
지난달의 실적startOfMonth-1mstartOfMonth-1d
이전 6개월startOfMonth-6mstartOfMonth-1d

사용할 수 있는 연산은 더하기(+)와 빼기(-)이며, 기간으로는 (y)ears, (m)onths, (w)eeks, (d)ays를 사용할 수 있습니다.

latest 키워드

latest 키워드는 약간 다르게 작동합니다. 이 키워드는 날짜 형식 YYYY-MM-DD에서 YYYY 또는 MM 대신에 사용할 수 있습니다. 예를 들어 최근 3월 14일이 latest-03-14이면 최근 달의 14일은 latest-latest-14입니다. 이 매개변수들은 미래 날짜를 반환하지 않습니다.

다음은 이해를 돕기 위한 몇 가지 예입니다.

요청현재 날짜결과
latest-03-142014-03-152014-03-14
latest-03-142014-03-142014-03-14
latest-03-142014-03-132013-03-14
latest-latest-142014-03-152014-03-14
latest-latest-142014-03-142014-03-14
latest-latest-142014-03-132013-02-14

상대적 날짜를 사용한 기간의 몇 가지 예는 다음과 같습니다.

보고서시작일종료일
최근 3월 14일latest-03-14latest-03-14
현재 미국 회계 연도까지(미국 회계 연도: 10월 1~9월 30일)latest-10-01today
마지막 급여 이후의 기간(예: 급여일이 매월 25일인 사람의 경우)latest-latest-25today

예시 보고서

다음은 지난 6개월의 월별 계정 실적을 보여 주는 예시 보고서입니다.

예시 보고서: 최근 6개월의 월간 수입 및 클릭수(최근 월이 맨 위에 표시됨)
시작일:startOfMonth-6m
종료일:startOfMonth-1d
측정기준:MONTH
측정항목:EARNINGS, CLICKS
정렬: -MONTH

결과:

{
     "kind": "adsense#report",
     "totalMatchedRows": "6",
     "headers": [
       {"name": "MONTH", "type": "DIMENSION" }
       {"name": "EARNINGS", "type": "METRIC_CURRENCY", "currency": "USD"}
       {"name": "PAGE_VIEWS", "type": "METRIC_TALLY"}
     ],
     "rows": [
       ["2013-03", "285", "46320"],
       ...
       ["2012-10", "298", "49201"]
     ],
     "totals": ["", "1841", "300278"],
     "averages": ["", "288", "47501", ]
}
    

예시 보고서
그림 3: 보고서 예시

다음 단계