구현: 채널

이 페이지에서는 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 탐색기를 사용하여 이 쿼리를 테스트할 수 없습니다.