Saltar al contenido principal

​
Zonas horarias, cuentas y facturación

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 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 utilizando 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 de zona horaria con un formato 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 zonas horarias en 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 gerente de cuenta del anunciante en X. Ten en cuenta el valor de timezone_switch_at al crear informes y al consultar nuestros endpoints de analíticas, ya que habrá un intervalo el día en que la cuenta cambie de la zona horaria America/Los_Angeles al nuevo valor local.

​
Especificación de 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 de zona horaria del estándar ISO 8601. Por ejemplo, 2017-07-10T08:00:00-0800 es un valor de entrada válido y se convertirá automáticamente al valor en 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 la medianoche del día deseado en la zona horaria local del titular de la cuenta. El desfase de zona horaria que se debe 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 desfase con respecto a 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 desfase 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 de UTC aceptados

Consulta Designadores de zona horaria de ISO 8601. Compatibles: Z, -HHMM, +HHMM, -HH:MM, +HH:MM, -HH, +HH
⌘I