Saltar al contenido principal

​
Zonas horarias, cuentas y facturación

Los valores de fecha y hora (datetime) siempre se devuelven en hora UTC (como lo indica la Z al final del valor de fecha y hora). Las fechas y horas se pueden especificar en cualquier zona horaria en un comando POST o PUT usando el formato estándar ISO 8601 para la zona horaria. 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 el que se fijan las cifras oficiales de facturación. Al consultar la API a nivel de cuenta (GET accounts), obtendrás información de zona horaria con un aspecto similar al siguiente: 
    {
      "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 el artículo sobre timezones at wikipedia para una descripció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 establece a nivel contractual/de facturación por el gestor de cuenta del anunciante en X. Ten en cuenta el valor de timezone_switch_at al crear informes y al consultar nuestros endpoints de analytics, ya que habrá un intervalo 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 hora UTC (como lo indica la Z al final del valor de fecha y hora). Las fechas y horas se pueden especificar en cualquier zona horaria en una solicitud POST o PUT utilizando el formato de zona horaria del estándar ISO 8601. Por ejemplo, 2017-07-10T08:00:00-0800 es un valor de entrada aceptable 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 de start_time debe especificarse a medianoche del día deseado en la zona horaria local del titular de la cuenta. El desplazamiento de la zona horaria que se usará será el desplazamiento del día actual, no el desplazamiento 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 ISO 8601. Formatos admitidos: Z, -HHMM, +HHMM, -HH:MM, +HH:MM, -HH, +HH