구현: 채널

이 페이지에서는 YouTube Data API (v3)를 사용하여 채널 데이터를 검색하고 업데이트하는 것과 관련된 기능을 수행하는 방법을 설명합니다. channel 리소스에는 채널에 업로드된 동영상과 좋아요 표시한 동영상을 식별하는 재생목록 ID가 포함됩니다. channels.list 메서드를 호출할 때 이 정보를 가져오려면 part 매개변수 값에 contentDetails 리소스 부분이 포함되어 있는지 확인합니다.

채널 정보 검색

channels.list 메서드를 호출하여 특정 채널에 관한 정보를 검색합니다. 채널을 식별하는 방법에는 여러 가지가 있습니다.

채널의 브랜딩 정보 설정

이 예에서는 채널의 브랜드 옵션을 업데이트합니다. 이 예시에는 다음 두 단계가 있습니다.

  • 1단계: 채널의 브랜드 옵션 검색하기

    channels.list 메서드를 호출하고 part 매개변수 값을 brandingSettings로, mine 매개변수 값을 true로 설정합니다.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=brandingSettings
        &mine=true

    애플리케이션은 검색된 설정을 표시하여 사용자가 업데이트할 설정을 수정할 수 있도록 합니다.

  • 2단계: 채널의 브랜드 옵션 업데이트하기

    channels.list 메서드를 호출하고 다음 값을 설정합니다.

    • id 속성을 채널의 고유 YouTube 채널 ID로 설정합니다. 1단계의 API 응답에서 ID를 추출할 수 있습니다.
    • part 매개변수 값을 brandingSettings로 설정합니다.

    아래 API 탐색기 링크는 다음 브랜딩 설정으로 channel 리소스를 만듭니다.

    {
  "id": "CHANNEL_ID",
  "brandingSettings": {
    "channel": {
      "description": "A great channel to be enjoyed by all.",
      "moderateComments": true,
      "showRelatedChannels": true,
      "showBrowseView": true,
      "featuredChannelsTitle": "Featured Channel Stuff",
      "featuredChannelsUrls": [
        "UC_x5XG1OV2P6uZZ5FSM9Ttw",
        "UCBR8-60-B28hp2BmDPdntcQ",
        "UCK8sQmJBp8GCxrOtXWBpyEA"
      ],
      "profileColor": "#006600"
    }
  }
}

    API 탐색기에서 요청을 완료하려면 id 속성 값을 인증된 사용자 채널의 채널 ID로 설정해야 합니다. 또한 현재 설정과 일치하도록 이미지 속성을 설정해야 합니다.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update?
        part=brandingSettings

채널 섹션 관리

API는 채널 섹션을 관리하기 위한 channelSections.list, channelSections.insert, channelSections.update, channelSections.delete 메서드를 지원합니다. 채널 섹션은 채널에 추천된 동영상 모음입니다. 예를 들어 채널의 최신 업로드, 가장 인기 있는 업로드, 하나 이상의 재생목록에서 가져온 동영상을 섹션에 포함할 수 있습니다.

아래 예시에서는 Google의 공식 YouTube 채널에 대한 채널 섹션을 검색합니다. 이 요청은 channelSections.list 메서드를 호출하고 channelId 매개변수 값을 Google 채널의 채널 ID인 UCK8sQmJBp8GCxrOtXWBpyEA로 설정합니다. 

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channelSections.list?
part=snippet,contentDetails
&channelId=UCK8sQmJBp8GCxrOtXWBpyEA

channelId 매개변수를 사용하는 대신 mine 매개변수 값을 true로 설정하면 이 요청에는 승인이 필요합니다. 이 매개변수는 현재 인증된 사용자의 채널에 대한 채널 섹션을 검색 중임을 나타냅니다.

채널에 워터마크 이미지 업로드 및 설정

watermarks.set 메서드를 호출하여 워터마크 이미지를 업로드하고 채널에 설정할 수 있습니다. 그런 다음 지정한 채널의 동영상을 재생하는 동안 이미지가 표시됩니다. 또한 이미지가 연결될 대상 채널뿐 아니라 워터마크가 표시되는 시점과 표시되는 기간을 결정하는 시간 세부정보도 지정할 수 있습니다.

watermarks.unset 메서드는 채널의 워터마크 이미지를 삭제합니다.

안타깝게도 API 탐색기에서 미디어 파일 업로드 기능을 지원하지 않으므로 API 탐색기를 사용하여 이 쿼리를 테스트할 수 없습니다.