Эта страница переведена с помощью Cloud Translation API.

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

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