메인 콘텐츠로 건너뛰기

​
시간대, 계정 및 청구

Datetime 값은 항상 UTC 시간으로 반환됩니다(날짜/시간 값 끝의 Z로 표시됩니다). Datetime 값은 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
      }
    }
여기에는 두 개의 타임존 값이 포함됩니다. timezone(개요는 위키피디아의 timezones 문서를 참고)와 timezone_switch_at입니다. timezone_switch_at 값은 UTC 타임존(+00:00)을 기준으로 제공되지만, 지정된 타임존에서의 자정 시점을 항상 나타낸다는 점에 유의하세요. 광고주의 타임존은 API를 통해 수정할 수 없습니다. 이 속성은 X의 광고주 계정 담당자에 의해 계약/청구 레벨에서 설정됩니다. 계정이 America/Los_Angeles 타임존에서 새로운 로컬 값으로 전환되는 날에는 해당 일자에 데이터 공백이 발생하므로, 리포트를 생성하고 애널리틱스 엔드포인트를 조회할 때 timezone_switch_at 값을 유의해서 사용하시기 바랍니다.

​
타임존이 포함된 Datetime 값 지정

Datetime 값은 항상 UTC 시간으로 반환됩니다(이는 datetime 값 끝에 있는 Z로 표시됩니다). Datetime 값은 POST 또는 PUT 명령에서 타임존에 대해 ISO 8601 표준 형식을 사용하여 어떤 타임존으로든 지정할 수 있습니다. 예를 들어, 2017-07-10T08:00:00-0800은 허용되는 입력 값이며 자동으로 UTC 값인 2017-07-10T16:00:00Z로 변환됩니다. granularity가 DAY 또는 TOTAL인 analytics 엔드포인트를 사용할 때, start_time 값은 계정 소유자의 로컬 타임존 기준으로 원하는 날짜의 자정으로 지정해야 합니다. 사용될 타임존 오프셋은 대상 날짜의 오프셋이 아니라 현재 날짜의 오프셋입니다. 예를 들어, America/Los_Angeles에 있는 광고 계정이 Pacific Daylight Savings 시간대에 있는 경우 UTC 오프셋은 -0700입니다. 따라서 analytics 요청에서 시간은 다음과 같이 지정해야 합니다: start_time=2017-05-21T07:00:00Z 또는 start_time=2017-05-21T00:00:00-0700. 광고 계정이 오프셋이 항상 +09:00인 Asia/Tokyo에 있는 경우, 값은 다음과 같이 지정합니다: 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