상대적인 날짜 키워드 사용

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

today
startOfMonth
startOfYear
latest

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

보고서	시작일	종료일
최근 7일의 실적	`today-6d`	`today`
지난달의 실적	`startOfMonth-1m`	`startOfMonth-1d`
이전 6개월	`startOfMonth-6m`	`startOfMonth-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-14`	2014-03-15	`2014-03-14`
`latest-03-14`	2014-03-14	`2014-03-14`
`latest-03-14`	2014-03-13	`2013-03-14`
`latest-latest-14`	2014-03-15	`2014-03-14`
`latest-latest-14`	2014-03-14	`2014-03-14`
`latest-latest-14`	2014-03-13	`2013-02-14`

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

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

예시 보고서

다음은 지난 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", ]
}

상대적인 날짜 키워드 사용

latest 키워드

예시 보고서

다음 단계

`latest` 키워드