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 유효한 키 값은 다음과 같습니다.
|
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.videoCount |
unsigned long 채널에 업로드된 동영상 수입니다. |
topicDetails |
object topicDetails 개체는 채널과 관련된 Freebase 주제에 대한 정보를 요약합니다. |
topicDetails.topicIds[] |
list 채널과 관련된 Freebase 주제 ID 목록입니다. Freebase Topic API를 사용하여 각 주제에 대한 정보를 검색할 수 있습니다. |
status |
object status 개체는 채널의 개인정보 보호 상태 정보를 요약합니다. |
status.privacyStatus |
string 채널의 개인정보 보호 상태입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
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 동영상 플레이어에 프로모션 항목을 배치하는 방식입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
invideoPromotion.position.cornerPosition |
string 프로모션 항목이 표시될 플레이어의 코너입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
invideoPromotion.items[] |
list 같은 시청자가 여러 번 재생할 때 프로모션 항목이 표시되는 순서 목록입니다. |
invideoPromotion.items[].id |
object 프로모션 항목을 식별합니다. |
invideoPromotion.items[].id.type |
string 프로모션 항목의 유형입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
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 이 프로모션에 표시할 맞춤 메시지입니다. 프로모션 항목이 웹사이트가 아닌 한, 이 필드는 현재 무시됩니다. |