시간대

​

시간대, 계정 및 청구

Datetime 값은 항상 UTC 시간으로 반환됩니다(값 끝의 Z로 표시). Datetime 값은 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(개요는 위키피디아의 timezones를 참조)과 timezone_switch_at. timezone_switch_at은 UTC 시간대(+00:00)로 제공되지만, 지정된 시간대에서는 항상 자정 시점을 나타낸다는 점에 유의하십시오.

광고주의 시간대는 API로 수정할 수 없습니다. 이 속성은 X의 광고주 담당자가 계약/청구 수준에서 설정합니다.

계정이 America/Los_Angeles 시간대에서 새로운 로컬 값으로 전환되는 날에는 공백 구간이 발생할 수 있으므로, 보고서를 생성하거나 분석 엔드포인트를 조회할 때 timezone_switch_at 값을 반드시 확인하십시오.

​

타임존을 포함한 날짜·시간 값 지정

날짜·시간 값은 항상 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의 광고 계정이 서머타임(Pacific Daylight Time) 중이라면 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