跳转到主要内容

​
时区、账户与计费

日期时间值始终以 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 的广告主账户经理在合同/结算层面进行设置。 在创建报告并查询我们的分析端点时，请留意 timezone_switch_at 的值，因为在账户从 America/Los_Angeles 时区切换到新的本地时区的当天会出现数据空档。

​
以时区指定日期时间值

日期时间值始终以 UTC 返回（由日期时间值末尾的 Z 表示）。在 POST 或 PUT 命令中，可以使用符合 ISO 8601 标准 的时区格式，以任意时区指定日期时间。例如，2017-07-10T08:00:00-0800 是可接受的输入值，并会自动转换为 UTC 值 2017-07-10T16:00:00Z。 在使用 granularity 为 DAY 或 TOTAL 的分析端点时，start_time 必须指定为账户持有者本地时区中目标日期的午夜。所用的时区偏移应为当前日期的偏移，而非目标日期的偏移。例如，对于位于 America/Los_Angeles 且处于太平洋夏令时期间的广告账户，UTC 偏移为 -0700。因此，在分析请求中，时间应指定为：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