Skip to main content

​
Zonas horarias, cuentas y facturación

Los valores de datetime siempre se devuelven en hora UTC (como indica la Z al final del valor de datetime). Los datetimes pueden especificarse en cualquier zona horaria en un comando POST o PUT usando el formato estándar ISO 8601 para zonas horarias. El tiempo se representa usando un subconjunto de ISO-8601. Más específicamente, la cadena strptime para nuestro formato de fecha es %Y-%m-%dT%l:%M:%S%z. La zona horaria de la cuenta del anunciante determina el momento real en que se congelan las cifras oficiales de facturación. Al consultar la API a nivel de cuenta (GET accounts), obtendrás información de zona horaria similar a esta:
Respuesta de ejemplo
Esto incluye dos valores de zona horaria: timezone (consulta timezones en wikipedia para una visión general) y timezone_switch_at. Ten en cuenta que timezone_switch_at se da en la zona horaria UTC (+00:00), pero siempre representará medianoche en la zona horaria dada. La zona horaria del anunciante no se puede editar a través de la API. Este atributo se establece a nivel contractual/de facturación por el gestor de la cuenta del anunciante en X. Ten en cuenta el valor timezone_switch_at al crear reportes y consultar nuestros endpoints de analytics, ya que habrá un salto en el día en el que la cuenta cambie de la zona horaria America/Los_Angeles al nuevo valor local.

​
Especificar valores de datetime con zona horaria

Los valores de datetime siempre se devuelven en hora UTC (como indica la Z al final del valor de datetime). Los datetimes pueden especificarse en cualquier zona horaria en un comando POST o PUT usando el formato estándar ISO 8601 para zonas horarias. Por ejemplo, 2017-07-10T08:00:00-0800 es un valor de entrada aceptable y se traducirá automáticamente al valor UTC 2017-07-10T16:00:00Z. Al usar los endpoints de analytics con granularity de DAY o TOTAL, el valor start_time debe especificarse a medianoche del día deseado en la zona horaria local del titular de la cuenta. El desplazamiento de zona horaria a usar será el del día actual, no el del día en cuestión. Por ejemplo, para una cuenta de anuncios en America/Los_Angeles durante el horario de verano del Pacífico, el desplazamiento UTC es -0700. Así, en una solicitud de analytics, el tiempo debe especificarse como: start_time=2017-05-21T07:00:00Z o start_time=2017-05-21T00:00:00-0700. Si la cuenta de anuncios estuviera en Asia/Tokyo, donde el desplazamiento es siempre +09:00, los valores se especificarían como: start_time=2017-05-20T15:00:00Z o start_time=2017-05-21T00:00:00+0900.

​
Formatos de desplazamiento UTC aceptados

Consulta los Designadores de zona horaria de ISO 8601. Soportados: Z, -HHMM, +HHMM, -HH:MM, +HH:MM, -HH, +HH