Cómo utilizar palabras clave de fechas relativas

Por comodidad, los parámetros startDate y endDate admiten las siguientes palabras clave especiales en lugar del formato YYYY-MM-DD estándar:

  • today
  • startOfMonth
  • startOfYear
  • latest

Permiten la generación de informes relativos a la fecha actual. Además, se pueden modificar:

InformesFecha de inicioFecha de finalización
Rendimiento de los últimos siete díastoday-6dtoday
Rendimiento del último messtartOfMonth-1mstartOfMonth-1d
Últimos seis mesesstartOfMonth-6mstartOfMonth-1d

Las operaciones disponibles son suma (+) y resta (-) y los intervalos son (y) años, (m) meses, (w) semanas y (d) días.

Palabra clave latest

La palabra clave latest funciona de un modo un poco distinto. Puedes utilizarla en lugar de YYYY o MM en el formato de fecha YYYY-MM-DD. Por ejemplo, el pasado 14 de marzo se expresaría como latest-03-14, mientras que el día 14 del mes pasado se expresaría como latest-latest-14. Estas expresiones nunca devuelven fechas del futuro.

A continuación, te mostramos algunos ejemplos para que lo veas más claro:

SolicitadoFecha actualResultado
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

A continuación, también puedes consultar algunos ejemplos de periodos que utilizan fechas relativas:

InformesFecha de inicioFecha de finalización
El pasado 14 de marzolatest-03-14latest-03-14
El año fiscal actual estadounidense hasta el momento (los años fiscales de Estados Unidos van del 1 de octubre al 30 de septiembre)latest-10-01today
El periodo transcurrido desde la última paga, para alguien que cobra el día 25 de cada meslatest-latest-25today

Un ejemplo de informe

A continuación, te ofrecemos un ejemplo de informe que muestra el rendimiento mensual de una cuenta durante los últimos seis meses.

Informe de ejemplo: ingresos y clics mensuales, últimos seis meses, se muestra el último mes en primer lugar
Fecha de inicio:startOfMonth-6m
Fecha de finalización:startOfMonth-1d
Dimensiones:MONTH
Métricas:EARNINGS, CLICKS
Orden:-MONTH

Resultado:

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

Informe de ejemplo
Figura 3: Informe de ejemplo

Pasos siguientes