Реализация: каналы

На этой странице рассказывается, как использовать YouTube Data API (v3) для получения и обновления данных канала. Ресурс channel содержит идентификаторы плейлистов, которые позволяют определить загруженные и понравившиеся видео канала. Чтобы получить эту информацию при вызове метода channels.list, убедитесь, что значение параметра part включает часть ресурса contentDetails.

Как получить информацию о канале

Вызовите метод channels.list, чтобы получить информацию об определенном канале. Определить канал можно несколькими способами:

• Чтобы получить информацию о канале YouTube текущего аутентифицированного пользователя, задайте для параметра mine значение true. Ваш запрос должен быть авторизован с помощью OAuth 2.0.

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

• Установите для параметра forUsername имя пользователя YouTube, чтобы получить информацию о канале, связанном с этим именем. В этом примере значение параметра forUsername задано как Google, чтобы получить информацию об официальном канале Google на YouTube.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
          part=snippet,contentDetails
          &forUsername=Google

• В качестве значения параметра id укажите идентификатор канала, информацию о котором вы хотите получить. В этом примере параметру id присвоено значение UCK8sQmJBp8GCxrOtXWBpyEA, которое также идентифицирует официальный канал Google на YouTube.

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

Как задать информацию о бренде канала

В этом примере обновляются настройки фирменного оформления канала. Пример состоит из двух шагов:

• Шаг 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. Идентификатор можно извлечь из ответа API на шаге 1.
  • Установите для параметра part значение brandingSettings.

  Ссылка на API Explorer ниже создает ресурс 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 Explorer, вам нужно задать значение свойства 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, равное UCK8sQmJBp8GCxrOtXWBpyEA (идентификатор канала Google).

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 Explorer, поскольку API Explorer не поддерживает загрузку медиафайлов, которая требуется для этого метода.