Channels

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

메소드

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

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

리소스 표현

아래의 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.insertplaylistItems.delete를 사용합니다.
contentDetails.relatedPlaylists.favorites string
채널의 즐겨찾기 동영상을 포함하는 재생목록의 ID입니다. 이 목록에서 항목을 추가하거나 제거하려면 playlistItems.insertplaylistItems.delete를 사용합니다.
contentDetails.relatedPlaylists.uploads string
채널의 업로드된 동영상을 포함하는 재생목록의 ID입니다. 새 동영상을 업로드하려면 videos.insert 메소드를 사용하고 이전에 업로드한 동영상을 삭제하려면 videos.delete 메소드를 사용합니다.
contentDetails.relatedPlaylists.watchHistory string
채널의 감상한 동영상 ID입니다. 이 목록에서 항목을 추가하거나 제거하려면 playlistItems.insertplaylistItems.delete를 사용합니다.
contentDetails.relatedPlaylists.watchLater string
채널의 나중에 볼 동영상 재생목록 ID입니다. 이 목록에서 항목을 추가하거나 제거하려면 playlistItems.insertplaylistItems.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을 표시합니다. 이 필드는 typewebsite 값이 있는 경우에만 존재합니다.

링크는 웹사이트, 판매자 사이트, 소셜 네트워크 사이트와 연결될 수 있습니다. 콘텐츠에 링크를 사용하는 것에 대한 자세한 내용은 관련된 웹사이트 및 판매자 사이트용 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
이 프로모션에 표시할 맞춤 메시지입니다. 프로모션 항목이 웹사이트가 아닌 한, 이 필드는 현재 무시됩니다.