Keywords für relative Datumsangaben verwenden

Zur Vereinfachung sind für die Parameter startDate und endDate anstelle des Standardformats YYYY-MM-DD auch spezielle Keywords zulässig:

  • today
  • startOfMonth
  • startOfYear
  • latest

Diese dienen zur Generierung von Berichten in Bezug auf das aktuelle Datum. Darüber hinaus können sie geändert werden:

BerichteStartdatumEnddatum
Leistung der letzten sieben Tagetoday-6dtoday
Leistung im letzten MonatstartOfMonth-1mstartOfMonth-1d
Vorherige sechs MonatestartOfMonth-6mstartOfMonth-1d

Verfügbar sind die Operationen Addition (+) und Subtraktion (-). Die Zeiträume sind Jahre (y), Monate (m), Wochen (w) und Tage (d).

Das Keyword latest

Das Keyword latest funktioniert ein bisschen anders. Sie können es im Datumsformat YYYY-MM-DD anstelle von YYYY oder MM verwenden. Der letzte 14. März wäre beispielsweise latest-03-14 und der letzte 14. des letzten Monats wäre latest-latest-14. Dabei werden nie Daten in der Zukunft zurückgegeben.

Hier einige Beispiele zur Veranschaulichung:

AngefordertAktuelles DatumErgebnis
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

Und hier einige Beispiele für die Verwendung relativer Datumsangaben in Zeiträumen:

BerichteStartdatumEnddatum
Der letzte 14. Märzlatest-03-14latest-03-14
Das bisherige Geschäftsjahr in den USA (beginnt am 1. Oktober und endet am 30. September)latest-10-01today
Der Zeitraum seit der letzten Gehaltsabrechnung für eine Person, die am 25. jeden Monats bezahlt wirdlatest-latest-25today

Beispielbericht

Hier sehen Sie einen Beispielbericht für die monatliche Leistung eines Kontos in den letzten sechs Monaten.

Beispielbericht: Monatliche Einnahmen und Klicks in den letzten sechs Monaten, letzten Monat zuerst anzeigen
Startdatum:startOfMonth-6m
Enddatum:startOfMonth-1d
Dimensionen:MONTH
Messwerte:EARNINGS, CLICKS
Sortierung:-MONTH

Ergebnis:

{
     "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", ]
}
    

Beispielbericht
Abbildung 3: Beispielbericht

Nächste Schritte