使用相對日期關鍵字

為了方便起見,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 個月的帳戶每月成效。

範例報表:最近 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:範例報表

其他訣竅

傳送您對下列選項的寶貴意見...

這個網頁
AdSense Host API
AdSense Host API