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

На этой странице объясняется, как использовать API данных YouTube (v3) для выполнения функций, связанных с получением и обновлением данных канала. Ресурс channel включает идентификаторы плейлистов, которые идентифицируют загруженные и понравившиеся видео на канале. Чтобы получить эту информацию при вызове метода 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. Идентификатор можно извлечь из ответа 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 не поддерживает возможность загрузки медиафайлов, которая является обязательным требованием для этого метода.