Vai al contenuto principale

​
Fusi orari, account e fatturazione

I valori di data e ora vengono sempre restituiti in UTC (come indicato dalla Z alla fine del valore). Le date e ore possono essere specificate in qualsiasi fuso orario in un comando POST o PUT utilizzando il formato standard ISO 8601 per il fuso orario. L’ora è rappresentata utilizzando un sottoinsieme di ISO 8601. Più nello specifico, la stringa strptime per il nostro formato di data è %Y-%m-%dT%l:%M:%S%z. Il fuso orario dell’account dell’inserzionista determina il momento esatto in cui i numeri ufficiali di fatturazione vengono bloccati. Quando si interroga l’API a livello di account (GET accounts), si otterranno informazioni sul fuso orario che si presentano in questo modo: 
    {
      "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
      }
    }
Questo include due valori di fuso orario: timezone (vedi time zones su Wikipedia per una panoramica) e timezone_switch_at. Nota che timezone_switch_at è espresso nel fuso orario UTC (+00:00), ma rappresenta sempre la mezzanotte nel fuso orario indicato. Il fuso orario dell’inserzionista non è modificabile tramite l’API. Questo attributo è definito a livello contrattuale/di fatturazione dal responsabile dell’account dell’inserzionista presso X. Tieni presente il valore di timezone_switch_at quando crei report ed esegui query sui nostri endpoint di analytics, poiché si verificherà un’interruzione nel giorno in cui l’account passa dal fuso orario America/Los_Angeles al nuovo valore locale.

​
Specificare valori datetime con fuso orario

I valori datetime sono sempre restituiti in UTC (come indicato dalla Z alla fine del valore). Le date e ore possono essere specificate in qualsiasi fuso orario in un comando POST o PUT utilizzando il formato per il fuso orario previsto dallo standard ISO 8601. Ad esempio, 2017-07-10T08:00:00-0800 è un valore di input valido e verrà automaticamente convertito nel valore UTC 2017-07-10T16:00:00Z. Quando si utilizzano gli endpoint di analytics con granularity impostata su DAY o TOTAL, il valore start_time deve essere indicato a mezzanotte del giorno desiderato nel fuso orario locale del titolare dell’account. L’offset del fuso orario da usare è quello del giorno corrente, non quello del giorno in questione. Ad esempio, per un account ads in America/Los_Angeles durante l’ora legale del Pacifico, l’offset UTC è -0700. Pertanto, in una richiesta di analytics, l’ora andrebbe specificata come: start_time=2017-05-21T07:00:00Z oppure start_time=2017-05-21T00:00:00-0700. Se l’account ads fosse in Asia/Tokyo, dove l’offset è sempre +09:00, i valori andrebbero specificati come: start_time=2017-05-20T15:00:00Z oppure start_time=2017-05-21T00:00:00+0900.

​
Formati di offset UTC accettati

Consulta i designatori di fuso orario ISO 8601. Supportati: Z, -HHMM, +HHMM, -HH:MM, +HH:MM, -HH, +HH
⌘I