Использование ключевых слов для обозначения дат

Для удобства работы в параметрах startDate и endDate можно использовать следующие специальные ключевые слова вместо стандартного формата ГГГГ-ММ-ДД:

  • today
  • startOfMonth
  • startOfYear
  • latest

Это позволяет создавать отчеты с текущей датой в качестве точки отсчета. Их также можно модифицировать:

ОтчетыДата началаДата окончания
Эффективность за последние 7 днейtoday-6dtoday
Эффективность за прошлый месяцstartOfMonth-1mstartOfMonth-1d
Предыдущие шесть месяцевstartOfMonth-6mstartOfMonth-1d

Доступные операции – сложение (+) и вычитание (-); доступные диапазоны – годы (y), месяцы (m), недели (w) и дни (d).

Ключевое слово latest

Ключевое слово latest работает немного иначе. Его можно использовать вместо ГГГГ или ММ в формате ГГГГ-ММ-ДД. Например, последнее 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

Вот ещё несколько примеров относительных диапазонов дат:

ОтчетыДата началаДата окончания
Последнее 14-е мартаlatest-03-14latest-03-14
Текущий финансовый год в США (финансовый год в США начинается 1 октября и заканчивается 30 сентября)latest-10-01today
Период с момента последней выплаты (при выплате дохода 25 числа каждого месяца)latest-latest-25today

Пример отчета

Ниже показан пример отчета по ежемесячной эффективности аккаунта за последние полгода.

Пример отчета. Ежемесячный доход и клики за последние шесть месяцев, начиная с прошедшего месяца
Дата начала: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