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

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

日時は常に UTC（日時値の末尾の Z が示します）で返されます。POST または PUT コマンドでは、タイムゾーンについて ISO 8601 の標準形式を用いることで、任意のタイムゾーンで日時を指定できます。時刻は 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 のタイムゾーンから新しいローカル値に切り替わる当日にはギャップが発生するため、レポートの作成や分析エンドポイントへのクエリ実行時は timezone_switch_at の値にご注意ください。

​
タイムゾーン付きの日時値の指定

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