Passer au contenu principal

​
Fuseaux horaires, comptes et facturation

Les valeurs de date et heure sont toujours renvoyées en UTC (comme l’indique le Z à la fin de la valeur). Les dates et heures peuvent être spécifiées dans n’importe quel fuseau horaire dans une commande POST ou PUT, en utilisant le format standard ISO 8601 pour les fuseaux horaires. L’heure est représentée à l’aide d’un sous-ensemble d’ISO 8601. Plus précisément, la chaîne strptime pour notre format de date est %Y-%m-%dT%l:%M:%S%z. Le fuseau horaire du compte de l’annonceur détermine l’heure exacte à laquelle les chiffres officiels de facturation sont figés. Lors de l’interrogation de l’API au niveau du compte (GET accounts), vous obtiendrez des informations de fuseau horaire de la forme suivante : 
    {
      "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
      }
    }
Cela inclut deux valeurs de fuseau horaire : timezone (voir timezones on Wikipedia pour un aperçu) et timezone_switch_at. Notez que timezone_switch_at est fourni dans le fuseau horaire UTC (+00:00), mais correspondra toujours à minuit dans le fuseau horaire indiqué. Le fuseau horaire de l’annonceur n’est pas modifiable via l’API. Cet attribut est défini au niveau contractuel/de facturation par le gestionnaire de compte de l’annonceur chez X. Veuillez tenir compte de la valeur timezone_switch_at lors de la création de rapports et de l’interrogation de nos endpoints d’analytics, car il y aura une lacune le jour où le compte passera du fuseau horaire America/Los_Angeles à la nouvelle valeur locale.

​
Spécifier des valeurs de date et heure avec fuseau horaire

Les valeurs de date et heure sont toujours renvoyées en UTC (comme l’indique le Z à la fin de la valeur). Les dates et heures peuvent être spécifiées dans n’importe quel fuseau horaire dans une commande POST ou PUT en utilisant le format de fuseau horaire de la norme ISO 8601. Par exemple, 2017-07-10T08:00:00-0800 est une valeur d’entrée acceptable et sera automatiquement convertie en la valeur UTC 2017-07-10T16:00:00Z. Lors de l’utilisation des endpoints d’analytics avec une granularity de DAY ou TOTAL, la valeur start_time doit être spécifiée à minuit du jour souhaité dans le fuseau horaire local du titulaire du compte. Le décalage horaire à utiliser sera celui du jour courant, et non celui du jour concerné. Par exemple, pour un compte publicitaire en America/Los_Angeles pendant l’heure d’été du Pacifique, le décalage UTC est -0700. Ainsi, dans une requête analytics, l’heure doit être spécifiée comme suit : start_time=2017-05-21T07:00:00Z ou start_time=2017-05-21T00:00:00-0700. Si le compte publicitaire se trouvait en Asia/Tokyo, où le décalage est toujours +0900, les valeurs seraient spécifiées comme suit : start_time=2017-05-20T15:00:00Z ou start_time=2017-05-21T00:00:00+0900.

​
Formats de décalage UTC acceptés

Voir désignateurs de fuseau horaire ISO 8601. Pris en charge : Z, -HHMM, +HHMM, -HH:MM, +HH:MM, -HH, +HH
⌘I