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

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

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

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

• Установите для параметра mine значение true , чтобы получить информацию о канале YouTube текущего аутентифицированного пользователя. Ваш запрос должен быть авторизован с использованием 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 идентификатор канала YouTube, который однозначно идентифицирует канал, информацию о котором вы получаете. В этом примере для параметра 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 не поддерживает возможность загрузки медиафайлов, которая является обязательным требованием для этого метода.