Channels

channel 리소스에는 YouTube 채널에 대한 정보가 포함되어 있습니다.

메소드

API는 channels 리소스에 다음 메소드를 지원합니다.

list: 요청 기준과 일치하는 0개 이상의 channel 리소스 집합을 반환합니다. 지금 사용해 보세요.
update: 채널의 메타데이터를 업데이트합니다. 이 메소드는 현재 channel 리소스의 brandingSettings 및 invideoPromotion 개체와 해당 하위 속성의 업데이트만 지원합니다. 지금 사용해 보세요.

리소스 표현

아래의 JSON 구조는 channels 리소스의 형식을 보여줍니다.

{
  "kind": "youtube#channel",
  "etag": etag,
  "id": string,
  "snippet": {
    "title": string,
    "description": string,
    "publishedAt": datetime,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  },
  "contentDetails": {
    "relatedPlaylists": {
      "likes": string,
      "favorites": string,
      "uploads": string,
      "watchHistory": string,
      "watchLater": string
    },
    "googlePlusUserId": string
  },
  "statistics": {
    "viewCount": unsigned long,
    "commentCount": unsigned long,
    "subscriberCount": unsigned long,
    "hiddenSubscriberCount": boolean,
    "videoCount": unsigned long
  },
  "topicDetails": {
    "topicIds": [
      string
    ]
  },
  "status": {
    "privacyStatus": string,
    "isLinked": boolean
  },
  "brandingSettings": {
    "channel": {
      "title": string,
      "description": string,
      "keywords": string,
      "defaultTab": string,
      "trackingAnalyticsAccountId": string,
      "moderateComments": boolean,
      "showRelatedChannels": boolean,
      "showBrowseView": boolean,
      "featuredChannelsTitle": string,
      "featuredChannelsUrls": [
        string
      ],
      "unsubscribedTrailer": string,
      "profileColor": string
    },
    "watch": {
      "textColor": string,
      "backgroundColor": string,
      "featuredPlaylistId": string
    },
    "image": {
      "bannerImageUrl": string,
      "bannerMobileImageUrl": string,
      "backgroundImageUrl": {
        "default": string,
        "localized": [
          {
            "value": string,
            "language": string
          }
        ]
      },
      "largeBrandedBannerImageImapScript": {
        "default": string,
        "localized": [
          {
            "value": string,
            "language": string
          }
        ]
      },
      "largeBrandedBannerImageUrl": {
        "default": string,
        "localized": [
          {
            "value": string,
            "language": string
          }
        ]
      },
      "smallBrandedBannerImageImapScript": {
        "default": string,
        "localized": [
          {
            "value": string,
            "language": string
          }
        ]
      },
      "smallBrandedBannerImageUrl": {
        "default": string,
        "localized": [
          {
            "value": string,
            "language": string
          }
        ]
      },
      "watchIconImageUrl": string,
      "trackingImageUrl": string,
      "bannerTabletLowImageUrl": string,
      "bannerTabletImageUrl": string,
      "bannerTabletHdImageUrl": string,
      "bannerTabletExtraHdImageUrl": string,
      "bannerMobileLowImageUrl": string,
      "bannerMobileMediumHdImageUrl": string,
      "bannerMobileHdImageUrl": string,
      "bannerMobileExtraHdImageUrl": string,
      "bannerTvImageUrl": string,
      "bannerExternalUrl": string
    },
    "hints": [
      {
        "property": string,
        "value": string
      }
    ]
  },
  "invideoPromotion": {
    "defaultTiming": {
      "type": string,
      "offsetMs": unsigned long,
      "durationMs": unsigned long
    },
    "position": {
      "type": string,
      "cornerPosition": string
    },
    "items": [
      {
        "id": {
          "type": string,
          "videoId": string,
          "websiteUrl": string
        },
        "timing": {
          "type": string,
          "offsetMs": unsigned long,
          "durationMs": unsigned long
        },
        "customMessage": string
      }
    ]
  }
}

속성

다음 표는 이 리소스에 표시되는 속성을 정의합니다.

속성 이름
`kind`	`string` API 리소스의 유형입니다. 값은 `youtube#channel`이 됩니다.
`etag`	`etag` 이 리소스의 Etag입니다.
`id`	`string` YouTube가 채널을 고유하게 식별하는 데 사용하는 ID입니다.
`snippet`	`object` `snippet` 개체는 제목, 설명 및 미리보기 이미지 등 채널에 대한 기본 세부정보를 포함합니다.
`snippet.title`	`string` 채널의 제목입니다.
`snippet.description`	`string` 채널의 설명입니다.
`snippet.publishedAt`	`datetime` 채널을 만든 날짜 및 시간입니다. 값은 ISO 8601 (`YYYY-MM-DDThh:mm:ss.sZ`) 형식으로 지정됩니다.
`snippet.thumbnails`	`object` 채널에 관련된 미리보기 이미지 맵입니다. 맵의 각 개체에 대해, 키는 미리보기 이미지의 이름이고 값은 미리보기 이미지에 대한 기타 정보를 포함하는 개체입니다.
`snippet.thumbnails.(key)`	`object` 유효한 키 값은 다음과 같습니다. `default` – 기본 미리보기 이미지입니다. 동영상에 대한 기본 미리보기 이미지 또는 재생목록 항목이나 검색결과 등 동영상을 참조하는 리소스이며 120x90픽셀입니다. 채널의 기본 미리보기 이미지는 88x88픽셀입니다. `medium` – 미리보기 이미지의 중간 해상도 버전입니다. 동영상 또는 동영상을 참조하는 리소스의 경우 이 이미지는 320x180픽셀입니다. 채널의 경우 이 이미지는 240x240픽셀입니다. `high` – 미리보기 이미지의 고해상도 버전입니다. 동영상 또는 동영상을 참조하는 리소스의 경우 이 이미지는 480x360픽셀입니다. 채널의 경우 이 이미지는 800x800픽셀입니다.
`snippet.thumbnails.(key).url`	`string` 이미지의 URL입니다.
`snippet.thumbnails.(key).width`	`unsigned integer` 이미지의 너비입니다.
`snippet.thumbnails.(key).height`	`unsigned integer` 이미지의 높이입니다.
`contentDetails`	`object` `contentDetails` 개체는 채널 콘텐츠에 대한 정보를 요악합니다.
`contentDetails.relatedPlaylists`	`object` `relatedPlaylists` 개체는 채널의 업로드된 동영상 또는 즐겨찾는 동영상 등 채널과 관련된 재생목록을 식별하는 맵입니다. `playlists.list` 메소드를 사용하여 모든 재생목록을 검색할 수 있습니다.
`contentDetails.relatedPlaylists.likes`	`string` 채널의 좋아요 표시가 된 동영상을 포함하는 재생목록의 ID입니다. 이 목록에서 항목을 추가하거나 제거하려면 `playlistItems.insert` 및 `playlistItems.delete`를 사용합니다.
`contentDetails.relatedPlaylists.favorites`	`string` 채널의 즐겨찾기 동영상을 포함하는 재생목록의 ID입니다. 이 목록에서 항목을 추가하거나 제거하려면 `playlistItems.insert` 및 `playlistItems.delete`를 사용합니다.
`contentDetails.relatedPlaylists.uploads`	`string` 채널의 업로드된 동영상을 포함하는 재생목록의 ID입니다. 새 동영상을 업로드하려면 `videos.insert` 메소드를 사용하고 이전에 업로드한 동영상을 삭제하려면 `videos.delete` 메소드를 사용합니다.
`contentDetails.relatedPlaylists.watchHistory`	`string` 채널의 감상한 동영상 ID입니다. 이 목록에서 항목을 추가하거나 제거하려면 `playlistItems.insert` 및 `playlistItems.delete`를 사용합니다.
`contentDetails.relatedPlaylists.watchLater`	`string` 채널의 나중에 볼 동영상 재생목록 ID입니다. 이 목록에서 항목을 추가하거나 제거하려면 `playlistItems.insert` 및 `playlistItems.delete`를 사용합니다.
`contentDetails.googlePlusUserId`	`string` `googlePlusUserId` 개체는 이 채널에 연결된 Google+ 프로필 ID를 식별합니다.
`statistics`	`object` `statistics` 개체는 채널의 통계를 요약합니다.
`statistics.viewCount`	`unsigned long` 채널이 조회된 횟수입니다.
`statistics.commentCount`	`unsigned long` 채널의 댓글 수입니다.
`statistics.subscriberCount`	`unsigned long` 채널의 구독자 수입니다.
`statistics.hiddenSubscriberCount`	`boolean` 채널의 구독자 수를 모든 사용자에게 공개할지 여부를 나타냅니다.
`statistics.videoCount`	`unsigned long` 채널에 업로드된 동영상 수입니다.
`topicDetails`	`object` `topicDetails` 개체는 채널과 관련된 Freebase 주제에 대한 정보를 요약합니다.
`topicDetails.topicIds[]`	`list` 채널과 관련된 Freebase 주제 ID 목록입니다. Freebase Topic API를 사용하여 각 주제에 대한 정보를 검색할 수 있습니다.
`status`	`object` `status` 개체는 채널의 개인정보 보호 상태 정보를 요약합니다.
`status.privacyStatus`	`string` 채널의 개인정보 보호 상태입니다. 이 속성에 유효한 값은 다음과 같습니다. `private` `public` `unlisted`
`status.isLinked`	`boolean` 채널 데이터가 YouTube 사용자 이름 또는 Google+ 계정에 이미 연결된 사용자를 식별하는지 여부를 나타냅니다. 이 중 하나에 연결된 사용자는 공개적인 YouTube ID가 이미 있습니다. 이 ID는 동영상 업로드 등 여러 작업을 하려면 반드시 필요합니다.
`brandingSettings`	`object` `brandingSettings` 개체는 채널 브랜드 정보를 요약합니다.
`brandingSettings.channel`	`object` `channel` 개체는 채널 페이지의 브랜드 속성을 요약합니다.
`brandingSettings.channel.title`	`string` 채널의 제목입니다. 제목의 길이는 최대 30자까지 가능합니다.
`brandingSettings.channel.description`	`string` 채널 페이지의 채널 정보 상자에 표시되는 채널 설명입니다.
`brandingSettings.channel.keywords`	`string` 채널과 관련된 키워드입니다. 값은 쉼표로 구분된 문자열의 목록입니다.
`brandingSettings.channel.defaultTab`	`string` 시청자가 채널 페이지를 방문할 때 사용자가 기본적으로 표시하는 콘텐츠 탭입니다.
`brandingSettings.channel.trackingAnalyticsAccountId`	`string` 채널의 트래픽을 추적하고 측정할 때 사용할 Google Analytics 계정의 ID입니다.
`brandingSettings.channel.moderateComments`	`boolean` 이 설정은 채널 소유자가 채널 페이지에 사용자가 제출한 댓글을 모든 사용자에게 공개하도록 허용할지 여부를 결정합니다. 기본값은 `false`입니다.
`brandingSettings.channel.showRelatedChannels`	`boolean` 이 설정은 YouTube에서 알고리즘으로 생성한 관련 채널의 목록을 채널 페이지에 표시할지 여부를 나타냅니다.
`brandingSettings.channel.showBrowseView`	`boolean` 이 설정은 채널 페이지가 탐색 또는 피드 보기에 콘텐츠를 표시할지 여부를 나타냅니다. 예를 들어 탐색 보기는 업로드된 동영상, 재생목록, 좋아하는 동영상에 대해 별도의 섹션을 표시할 수 있습니다. 반면 피드 보기는 채널의 활동 피드를 표시합니다.
`brandingSettings.channel.featuredChannelsTitle`	`string` 추천 채널 모듈 위에 표시되는 제목입니다.
`brandingSettings.channel.featuredChannelsUrls[]`	`list` 추천 채널 모듈에서 연결하려는 최대 16개의 채널입니다. 속성 값은 YouTube 채널 ID 값의 목록이며 각 값은 채널을 고유하게 식별합니다.
`brandingSettings.channel.unsubscribedTrailer`	`string` 구독하지 않은 시청자를 위한 채널 페이지 탐색 보기의 추천 동영상 모듈에서 재생해야 하는 동영상입니다. 구독자는 최근 채널 활동을 더 강조표시하는 다른 보기를 볼 수 있습니다.
`brandingSettings.channel.profileColor`	`string` 채널의 콘텐츠를 보완하는 눈에 띄는 색입니다.
`brandingSettings.watch`	`object` `watch` 개체는 채널 동영상 보기 페이지의 브랜드 속성을 요약합니다.
`brandingSettings.watch.textColor`	`string` 동영상 보기 페이지 브랜드 영역의 배경 색상입니다.
`brandingSettings.watch.backgroundColor`	`string` 동영상 보기 페이지 브랜드 영역의 텍스트 색상입니다.
`brandingSettings.watch.featuredPlaylistId`	`string` 동영상 보기 페이지의 동영상 플레이어 옆에 표시되는 재생목록을 고유하게 식별하는 ID입니다.
`brandingSettings.image`	`object` `image` 개체는 채널의 채널 페이지 또는 동영상 보기 페이지에 표시되는 이미지에 대한 정보를 요약합니다.
`brandingSettings.image.bannerImageUrl`	`string` YouTube 웹사이트의 채널 페이지에 표시되는 배너 이미지의 URL입니다. 이미지는 1060x175픽셀입니다.
`brandingSettings.image.bannerMobileImageUrl`	`string` 모바일 애플리케이션의 채널 페이지에 표시되는 배너 이미지의 URL입니다. 이미지는 640x175픽셀입니다.
`brandingSettings.image.backgroundImageUrl`	`object` `backgroundImageUrl` 개체는 동영상 보기 페이지에 표시되는 배경 이미지의 설정을 요약합니다. 이미지는 1200x615픽셀이고 최대 파일 크기는 128k입니다.
`brandingSettings.image.backgroundImageUrl.default`	`string` 속성의 기본값입니다.
`brandingSettings.image.backgroundImageUrl.localized[]`	`list` 속성의 언어별 값을 지정하는 개체 목록입니다.
`brandingSettings.image.backgroundImageUrl.localized[].value`	`string` 지정된 언어의 속성 값입니다.
`brandingSettings.image.backgroundImageUrl.localized[].language`	`string` 값과 관련된 언어입니다.
`brandingSettings.image.largeBrandedBannerImageImapScript`	`object` `largeBrandedBannerImageImapScript` 개체는 채널 페이지에 표시된 배너 이미지의 이미지 맵 스크립트에 대한 정보를 요약합니다.
`brandingSettings.image.largeBrandedBannerImageImapScript.default`	`string` 속성의 기본값입니다.
`brandingSettings.image.largeBrandedBannerImageImapScript.localized[]`	`list` 속성의 언어별 값을 지정하는 개체 목록입니다.
`brandingSettings.image.largeBrandedBannerImageImapScript.localized[].value`	`string` 지정된 언어의 속성 값입니다.
`brandingSettings.image.largeBrandedBannerImageImapScript.localized[].language`	`string` 값과 관련된 언어입니다.
`brandingSettings.image.largeBrandedBannerImageUrl`	`object` 동영상 보기 페이지의 확장 동영상 보기에서 동영상 플레이어 아래에 표시되는 854x70픽셀인 이미지의 URL입니다.
`brandingSettings.image.largeBrandedBannerImageUrl.default`	`string` 속성의 기본값입니다.
`brandingSettings.image.largeBrandedBannerImageUrl.localized[]`	`list` 속성의 언어별 값을 지정하는 개체 목록입니다.
`brandingSettings.image.largeBrandedBannerImageUrl.localized[].value`	`string` 지정된 언어의 속성 값입니다.
`brandingSettings.image.largeBrandedBannerImageUrl.localized[].language`	`string` 값과 관련된 언어입니다.
`brandingSettings.image.smallBrandedBannerImageImapScript`	`object` 작은 배너 이미지의 이미지 맵 스크립트입니다. `largeBrandedBannerImageImapScript` 개체는 모바일 애플리케이션의 채널 페이지에 표시된 배너 이미지의 이미지 맵 스크립트에 대한 정보를 요약합니다.
`brandingSettings.image.smallBrandedBannerImageImapScript.default`	`string` 속성의 기본값입니다.
`brandingSettings.image.smallBrandedBannerImageImapScript.localized[]`	`list` 속성의 언어별 값을 지정하는 개체 목록입니다.
`brandingSettings.image.smallBrandedBannerImageImapScript.localized[].value`	`string` 지정된 언어의 속성 값입니다.
`brandingSettings.image.smallBrandedBannerImageImapScript.localized[].language`	`string` 값과 관련된 언어입니다.
`brandingSettings.image.smallBrandedBannerImageUrl`	`object` 동영상 보기 페이지의 기본 보기에서 동영상 플레이어 아래에 표시되는 640x70픽셀인 배너 이미지의 URL입니다.
`brandingSettings.image.smallBrandedBannerImageUrl.default`	`string` 속성의 기본값입니다.
`brandingSettings.image.smallBrandedBannerImageUrl.localized[]`	`list` 속성의 언어별 값을 지정하는 개체 목록입니다.
`brandingSettings.image.smallBrandedBannerImageUrl.localized[].value`	`string` 지정된 언어의 속성 값입니다.
`brandingSettings.image.smallBrandedBannerImageUrl.localized[].language`	`string` 값과 관련된 언어입니다.
`brandingSettings.image.watchIconImageUrl`	`string` 동영상 플레이어 위에 표시되는 이미지의 URL입니다. 높이가 25픽셀이며 너비가 최대 170픽셀까지 조정 가능한 이미지입니다. 이 이미지를 제공하지 않으면 채널 이름이 이미지 대신 표시됩니다.
`brandingSettings.image.trackingImageUrl`	`string` 채널이나 동영상 페이지 조회수의 통계를 수집할 때 사용할 수 있는 1x1픽셀인 추적 픽셀의 URL입니다.
`brandingSettings.image.bannerTabletLowImageUrl`	`string` 태블릿 애플리케이션의 채널 페이지에 표시되는 저해상도 배너 이미지의 URL입니다. 이미지는 1138x188픽셀입니다.
`brandingSettings.image.bannerTabletImageUrl`	`string` 태블릿 애플리케이션의 채널 페이지에 표시되는 배너 이미지의 URL입니다. 이미지는 1707x283픽셀입니다.
`brandingSettings.image.bannerTabletHdImageUrl`	`string` 태블릿 애플리케이션의 채널 페이지에 표시되는 고해상도 배너 이미지의 URL입니다. 이미지는 2276x377픽셀입니다.
`brandingSettings.image.bannerTabletExtraHdImageUrl`	`string` 태블릿 애플리케이션의 채널 페이지에 표시되는 초고해상도 배너 이미지의 URL입니다. 이미지는 2560x424픽셀입니다.
`brandingSettings.image.bannerMobileLowImageUrl`	`string` 모바일 애플리케이션의 채널 페이지에 표시되는 저해상도 배너 이미지의 URL입니다. 이미지는 320x88픽셀입니다.
`brandingSettings.image.bannerMobileMediumHdImageUrl`	`string` 모바일 애플리케이션의 채널 페이지에 표시되는 중간 해상도 배너 이미지의 URL입니다. 이미지는 960x263픽셀입니다.
`brandingSettings.image.bannerMobileHdImageUrl`	`string` 모바일 애플리케이션의 채널 페이지에 표시되는 고해상도 배너 이미지의 URL입니다. 이미지는 1280x360픽셀입니다.
`brandingSettings.image.bannerMobileExtraHdImageUrl`	`string` 모바일 애플리케이션의 채널 페이지에 표시되는 매우 고해상도 배너 이미지의 URL입니다. 이미지는 1440x395픽셀입니다.
`brandingSettings.image.bannerTvImageUrl`	`string` 텔레비전 애플리케이션의 채널 페이지에 표시되는 배너 이미지의 URL입니다. 이미지는 2120x1192픽셀입니다.
`brandingSettings.image.bannerExternalUrl`	`string` 참고: 이 속성은 `channels.update` 요청에서만 사용할 수 있습니다. 이 속성은 YouTube가 채널의 다양한 배너 이미지 크기를 생성하기 위해 사용할 배너 이미지의 위치를 지정합니다. URL 배너 이미지의 외부 URL을 구하려면 먼저 `channelBanners.insert` 메소드를 호출하여 사용하려는 채널 배너 이미지를 업로드합니다.
`brandingSettings.hints[]`	`list` `hints` 개체는 추가 브랜드 속성을 요약합니다.
`brandingSettings.hints[].property`	`string` 속성입니다.
`brandingSettings.hints[].value`	`string` 속성의 값입니다.
`invideoPromotion`	`object` `invideoPromotion` 개체는 채널과 관련된 프로모션 캠페인에 대한 정보를 요약합니다. 채널 동영상을 재생하는 동안 채널은 동영상 플레이어에 프로모션 동영상의 미리보기 이미지를 표시하기 위해 동영상 내 프로모션 캠페인을 사용할 수 있습니다.
`invideoPromotion.defaultTiming`	`object` `defaultTiming` 개체는 동영상 재생 중 프로모션 항목이 표시될 채널의 기본 타이밍 설정을 식별합니다. 이러한 기본 설정은 프로모션 항목에 대한 보다 구체적인 `timing` 설정으로 덮어쓸 수 있습니다.
`invideoPromotion.defaultTiming.type`	`string` 동영상 재생 중 프로모션 항목을 삽입할 시기를 결정하는 타이밍 메소드입니다. 값이 `offsetFromStart`인 경우 `offsetMs` 필드는 동영상 시작부터 오프셋을 나타냅니다. 값이 `offsetFromEnd`인 경우 `offsetMs` 필드는 동영상 끝부터 오프셋을 나타냅니다.
`invideoPromotion.defaultTiming.offsetMs`	`unsigned long` 동영상 재생 중 프로모션 항목을 표시할 시기를 결정하는 밀리초로 지정된 시간 오프셋입니다. `type` 속성의 값은 동영상의 시작 또는 끝 중 어디부터 오프셋을 측정할지를 결정합니다.
`invideoPromotion.defaultTiming.durationMs`	`unsigned long` 프로모션 항목이 표시되는 길이를 밀리초로 정의합니다. 누락되는 경우 고객은 기본값을 사용해야 합니다.
`invideoPromotion.position`	`object` `position` 개체는 프로모션 항목이 표시될 동영상 내 공간 위치에 대한 정보를 요약합니다.
`invideoPromotion.position.type`	`string` 동영상 플레이어에 프로모션 항목을 배치하는 방식입니다. 이 속성에 유효한 값은 다음과 같습니다. `corner`
`invideoPromotion.position.cornerPosition`	`string` 프로모션 항목이 표시될 플레이어의 코너입니다. 이 속성에 유효한 값은 다음과 같습니다. `bottomLeft` `bottomRight` `topLeft` `topRight`
`invideoPromotion.items[]`	`list` 같은 시청자가 여러 번 재생할 때 프로모션 항목이 표시되는 순서 목록입니다.
`invideoPromotion.items[].id`	`object` 프로모션 항목을 식별합니다.
`invideoPromotion.items[].id.type`	`string` 프로모션 항목의 유형입니다. 이 속성에 유효한 값은 다음과 같습니다. `video` `website`
`invideoPromotion.items[].id.videoId`	`string` 프로모션 항목이 동영상을 표시하는 경우 이 값이 존재하고 YouTube에서 동영상을 식별하기 위해 지정한 YouTube ID를 식별합니다. 이 필드는 `type` 속성의 값이 `video`인 경우에만 존재합니다.
`invideoPromotion.items[].id.websiteUrl`	`string` 프로모션 항목이 웹사이트를 표시하는 경우 이 필드는 웹사이트를 가리키는 url을 표시합니다. 이 필드는 `type`에 `website` 값이 있는 경우에만 존재합니다. 링크는 웹사이트, 판매자 사이트, 소셜 네트워크 사이트와 연결될 수 있습니다. 콘텐츠에 링크를 사용하는 것에 대한 자세한 내용은 관련된 웹사이트 및 판매자 사이트용 YouTube 도움말 센터 안내를 참조하세요. 프로모션 링크를 추가함으로써, 귀하는 이 링크가 승인되지 않은 사이트로 트래픽을 리디렉션하는 데 사용되지 않고 애드워즈 정책, YouTube 광고 정책, YouTube 커뮤니티 가이드 및 YouTube 서비스 약관을 준수하는 것에 동의합니다.
`invideoPromotion.items[].timing`	`object` 동영상 재생 중 프로모션 항목이 표시되는 시간입니다. 이 타이밍 설정은 채널의 기본 타이밍 설정을 덮어씁니다.
`invideoPromotion.items[].timing.type`	`string` 동영상 재생 중 프로모션 항목을 삽입할 시기를 결정하는 타이밍 메소드입니다. 값이 `offsetFromStart`인 경우 `offsetMs` 필드는 동영상 시작부터 오프셋을 나타냅니다. 값이 `offsetFromEnd`인 경우 `offsetMs` 필드는 동영상 끝부터 오프셋을 나타냅니다.
`invideoPromotion.items[].timing.offsetMs`	`unsigned long` 동영상 재생 중 프로모션 항목을 표시할 시기를 결정하는 밀리초로 지정된 시간 오프셋입니다. `type` 속성의 값은 동영상의 시작 또는 끝 중 어디부터 오프셋을 측정할지를 결정합니다.
`invideoPromotion.items[].timing.durationMs`	`unsigned long` 프로모션 항목이 표시되는 길이를 밀리초로 정의합니다. 누락되는 경우 고객은 기본값을 사용해야 합니다.
`invideoPromotion.items[].customMessage`	`string` 이 프로모션에 표시할 맞춤 메시지입니다. 프로모션 항목이 웹사이트가 아닌 한, 이 필드는 현재 무시됩니다.