メインコンテンツへスキップ

​
タイムゾーン、アカウント、請求

日時値は常に 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
      }
    }
これには2つのタイムゾーン値が含まれます: timezone（概要はWikipedia の timezonesを参照）と timezone_switch_at です。timezone_switch_at は UTC（+00:00）で示されますが、常に指定されたタイムゾーンにおける深夜0時を表します。 広告主のタイムゾーンは API では編集できません。この属性は、X の広告主担当アカウントマネージャーにより契約/請求レベルで設定されます。 アカウントが America/Los_Angeles から新しいローカルタイムゾーンに切り替わる当日にはギャップが発生するため、レポートの作成や分析用 endpoint に対する timezone_switch_at 値を用いた query の実行時にはご注意ください。

​
タイムゾーンを含む日時値の指定

日時値は常にUTC時刻で返されます（日時値の末尾にある Z がそのことを示します）。日時は、タイムゾーンの表記に ISO 8601 形式を用いることで、POST または PUT コマンド内で任意のタイムゾーンで指定できます。たとえば、2017-07-10T08:00:00-0800 は有効な入力値であり、自動的にUTCの 2017-07-10T16:00:00Z に変換されます。 granularity が DAY または TOTAL の analytics endpoint を使用する場合、start_time はアカウント保有者のローカルタイムゾーンにおける対象日の午前0時で指定する必要があります。使用されるタイムゾーンオフセットは、対象日のオフセットではなく当日（現在日）のオフセットです。たとえば、America/Los_Angeles の広告アカウントが夏時間（Pacific Daylight Time）期間中であれば、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