Saltar al contenido principal

​
Zonas horarias, cuentas y facturación

Los valores de fecha y hora siempre se devuelven en UTC (como lo indica la Z al final del valor). Las fechas y horas pueden especificarse en cualquier zona horaria en un comando POST o PUT utilizando el formato estándar ISO 8601 para zonas horarias. La hora 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 exacto en que se congelan las cifras oficiales de facturación. Al consultar la API a nivel de cuenta (GET accounts), obtendrá información sobre la zona horaria con el siguiente formato: 
    {
      "request": {
        "params": {
          "account_id": "18ce54d4x5t"
        }
      },
      "data": {
        "name": "API McTestface",
        "business_name": null,
        "timezone": "America/Los_Angeles",
        "timezone_switch_at": "2016-07-21T07:00:00Z",
        "id": "18ce54d4x5t",
        "created_at": "2016-07-21T22:42:09Z",
        "salt": "54cb7b5a34183f77d82dd6d0f4329691",
        "updated_at": "2017-09-09T06:42:14Z",
        "business_id": null,
        "approval_status": "ACCEPTED",
        "deleted": false
      }
    }
Esto incluye dos valores de zona horaria: timezone (consulta las zonas horarias en Wikipedia para una visión general) y timezone_switch_at. Ten en cuenta que timezone_switch_at se proporciona en la zona horaria UTC (+00:00), pero siempre representará la medianoche en la zona horaria indicada. La zona horaria del anunciante no se puede editar mediante la API. Este atributo se define a nivel contractual/de facturación por el gestor de cuentas del anunciante en X. Ten en cuenta el valor de timezone_switch_at al crear informes y consultar nuestros endpoints de analíticas, ya que habrá una discontinuidad el día en que la cuenta cambie de la zona horaria America/Los_Angeles al nuevo valor local.

​
Especificar valores de fecha y hora con zona horaria

Los valores de fecha y hora siempre se devuelven en UTC (como lo indica la Z al final del valor). Las fechas y horas pueden especificarse en cualquier zona horaria en un comando POST o PUT usando el formato del estándar ISO 8601 para zonas horarias. Por ejemplo, 2017-07-10T08:00:00-0800 es un valor de entrada válido y se convertirá 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 la 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. Por lo tanto, en una solicitud de analytics, la hora 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 Designadores de zona horaria de ISO 8601. Se admiten: Z, -HHMM, +HHMM, -HH:MM, +HH:MM, -HH, +HH