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

Реализация: Подписки

В следующих примерах показано, как использовать API данных YouTube (v3) для выполнения функций, связанных с подписками.

Получить подписки канала

Вызовите метод subscriptions.list , чтобы получить подписки для определенного канала. Есть два способа определить канал:

Чтобы получить подписки текущего аутентифицированного пользователя, установите для параметра mine значение true . Обратите внимание, что запрос, использующий параметр mine , должен быть авторизован с использованием OAuth 2.0.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mine=true
```
Чтобы получить подписки для любого другого канала, задайте в качестве значения параметра channelId уникальный идентификатор канала YouTube этого канала. В приведенном ниже примере извлекается список каналов, на которые подписан канал TED на YouTube.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &channelId=UCAuUUnT6oDeKwE6v1NGQxug
```
Примечание. API возвращает код ответа HTTP 403 (Forbidden) , если указанный канал не раскрывает публично свои подписки и запрос не авторизован владельцем канала.

Примеры кода см. в документации по методу subscriptions.list .

Добавить подписку

Вызовите метод subscriptions.insert , чтобы добавить подписку на канал. Этот запрос должен быть авторизован с использованием OAuth 2.0. Тело запроса — это ресурс subscription , который устанавливает следующие значения:

snippet.resourceId.kind содержит значение youtube#channel .
Свойство snippet.resourceId.channelId определяет канал, на который вы подписываетесь. Значением свойства является уникальный идентификатор канала YouTube. Идентификатор канала можно получить несколькими способами, включая вызов метода channels.list или получение результатов поиска для каналов .

Приведенный ниже запрос API подпишет вас на канал TED на YouTube:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.insert?
        part=snippet

Тело запроса:

{
  "snippet": {
    "resourceId": {
      "kind": "youtube#channel",
      "videoId": "UCAuUUnT6oDeKwE6v1NGQxug"
    }
  }
}

Примеры кода см. в документации по методу subscriptions.insert .

Удалить подписку

В этом примере удаляется подписка. Этот запрос должен быть авторизован с использованием OAuth 2.0. Этот пример состоит из двух шагов:

Шаг 1. Получите подписки на канал аутентифицированного пользователя.
Вызовите метод subscriptions.list , чтобы получить список подписок. В приведенном выше примере для получения подписок канала объясняется, как сделать этот запрос.
Приложение, вызывающее API, может обработать ответ API для отображения списка подписок, используя идентификатор каждой подписки в качестве ключа. В ответе свойство id каждого элемента идентифицирует идентификатор подписки, который однозначно идентифицирует соответствующую подписку. Вы будете использовать это значение для удаления элемента из списка на следующем шаге.
Шаг 2. Удалить подписку
Вызовите метод subscriptions.delete , чтобы удалить подписку. Задайте для параметра id запроса идентификатор подписки для подписки, которую вы хотите удалить. Этот запрос должен быть авторизован с использованием OAuth 2.0.
Чтобы выполнить запрос в обозревателе API, вам необходимо установить значение свойства id .
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.delete?
        id=SUBSCRIPTION_ID
```

Примеры кода см. в документации по методу subscriptions.delete .

Получить список подписчиков на канал авторизованного пользователя

Чтобы получить список каналов, которые подписываются на канал текущего пользователя, прошедшего проверку подлинности, вызовите метод subscriptions.list и установите для параметра mySubscribers значение true . Запрос должен быть авторизован с использованием OAuth 2.0.

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