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

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

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

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

  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 Explorer, необходимо задать значение свойства 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