跳转到主要内容

​
时区、账户与计费

日期时间值始终以 UTC 返回（由值末尾的 Z 表示）。在使用 ISO 8601 标准时区格式的 POST 或 PUT 命令中，可以以任意时区指定日期时间。时间采用 ISO-8601 的一个子集表示。更具体地说，我们的日期格式对应的 strptime 字符串为 %Y-%m-%dT%l:%M:%S%z。广告主账户的时区决定官方计费数据冻结的实际时间点。 在账户级别查询 API（GET accounts）时，您将看到如下所示的时区信息： 
    {
      "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
      }
    }
其中包含两个时区相关的值：timezone（概览请参见维基百科的“时区”条目）和 timezone_switch_at。请注意，timezone_switch_at 以 UTC 时区（+00:00）给出，但它始终表示所给定时区的午夜时间。 广告主的时区无法通过 API 编辑。该属性由 X 的广告主客户经理在合同/计费层级进行设置。 在创建报告并查询我们的分析 endpoint 时，请留意 timezone_switch_at 的取值，因为当账户从 America/Los_Angeles 时区切换到新的本地时区的当天，会出现一个间隙。

​
使用带时区的日期时间值

日期时间值始终以 UTC 返回（由值末尾的 Z 表示）。在 POST 或 PUT 命令中，可以按照 ISO 8601 标准 的时区格式，以任意时区指定日期时间。例如，2017-07-10T08:00:00-0800 是可接受的输入值，并会自动转换为 UTC 值 2017-07-10T16:00:00Z。 当在 analytics endpoint 中将 granularity 设为 DAY 或 TOTAL 时，start_time 必须指定为账户持有人本地时区中目标日期的午夜。应使用的时区偏移为当前日期的偏移，而非目标日期当日的偏移。例如，对于位于 America/Los_Angeles 的广告账户，在太平洋夏令时期间，其 UTC 偏移为 -0700。因此，在 analytics 请求中，时间应指定为：start_time=2017-05-21T07:00:00Z 或 start_time=2017-05-21T00:00:00-0700。如果广告账户位于 Asia/Tokyo（该地区的偏移始终为 +09:00），则应指定为：start_time=2017-05-20T15:00:00Z 或 start_time=2017-05-21T00:00:00+0900。

​
支持的 UTC 偏移格式

参见 ISO 8601 时区标识符。 支持：Z、-HHMM、+HHMM、-HH:MM、+HH:MM、-HH、+HH
⌘I