구현: 채널

이 페이지에서는 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로 설정합니다. ID는 1단계의 API 응답에서 추출할 수 있습니다.
    • 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 탐색기에서 이 메서드의 요구사항인 미디어 파일 업로드 기능을 지원하지 않기 때문입니다.