タイムゾーン、アカウント、請求
日時値は常に UTC で返されます(日時値の末尾の Z で示されます)。POST または PUT コマンドで日時を指定する際は、タイムゾーンについて ISO 8601 標準形式を用いて任意のタイムゾーンで指定できます。時刻は ISO-8601 のサブセットで表現されます。より具体的には、この日付形式に対する strptime 文字列は%Y-%m-%dT%l:%M:%S%z です。広告主アカウントのタイムゾーンは、公式請求数値が確定する実際の時刻を決定します。
アカウントレベルで API に問い合わせる(GET accounts)と、以下のようなタイムゾーン情報が得られます。
Example response
timezone(Wikipedia のタイムゾーンを参照)および timezone_switch_at です。timezone_switch_at は UTC タイムゾーン(+00:00)で表されますが、常に指定タイムゾーンの深夜 0 時を表します。
広告主のタイムゾーンは API から編集できません。この属性は、契約/請求レベルで X の広告主のアカウントマネージャーにより設定されます。
レポート作成や analytics エンドポイントへの問い合わせを行う際は、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 エンドポイントを granularity が DAY または TOTAL で使用する場合、start_time の値は、アカウント保有者のローカルタイムゾーンにおける対象日の深夜 0 時で指定する必要があります。使用するタイムゾーンオフセットは、対象日のオフセットではなく、現在の日のオフセットです。たとえば、Pacific Daylight Savings 期間中の 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 Time zone designators を参照してください。 サポート形式:Z, -HHMM, +HHMM, -HH:MM, +HH:MM, -HH, +HH