使用相对日期关键字

为方便起见,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日期格式中的YYYYMM。例如,最近的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个月的月收入和点击次数,上个月数据在最上面
开始日期: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", ]
}
    

Example report
图3:示例报告

后续步骤

发送以下问题的反馈:

此网页
AdSense Management API
AdSense Management API