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

В следующих примерах показано, как использовать 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 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