Implementação: assinaturas

Chame o método subscriptions.list para recuperar as assinaturas de um canal específico. Há duas maneiras de identificar o canal:

• Para recuperar as assinaturas do usuário autenticado, defina o valor do parâmetro mine como true. Uma solicitação que usa o parâmetro mine precisa ser autorizada usando o OAuth 2.0.

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

• Para recuperar as inscrições de qualquer outro canal, defina o valor do parâmetro channelId como o ID exclusivo do canal do YouTube. O exemplo abaixo recupera uma lista de canais em que o canal TED está inscrito no YouTube.

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

  Observação:a API vai retornar um código de resposta HTTP 403 (Forbidden) se o canal especificado não expor publicamente as assinaturas e a solicitação não for autorizada pelo proprietário do canal.

Consulte a documentação do método subscriptions.list para conferir exemplos de código.

Chame o método subscriptions.insert para adicionar uma assinatura de canal. Essa solicitação precisa ser autorizada usando o OAuth 2.0. O corpo da solicitação é um recurso subscription que define os seguintes valores:

• O snippet.resourceId.kind contém o valor youtube#channel.
• A propriedade snippet.resourceId.channelId identifica o canal em que a pessoa está inscrita. O valor da propriedade é um ID exclusivo do canal do YouTube. O ID do canal pode ser obtido de várias maneiras, incluindo a chamada do método channels.list ou a recuperação de resultados da pesquisa para canais.

A solicitação de API abaixo inscreve você no canal TED no YouTube:

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

O corpo da solicitação é:

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

Consulte a documentação do método subscriptions.insert para conferir exemplos de código.

Este exemplo exclui uma assinatura. Essa solicitação precisa ser autorizada usando o OAuth 2.0. Este exemplo tem duas etapas:

• Etapa 1: extrair as assinaturas do canal do usuário autenticado

  Chame o método subscriptions.list para recuperar a lista de assinaturas. O exemplo acima para recuperar as inscrições de um canal explica como fazer essa solicitação.

  O aplicativo que chama a API pode processar a resposta da API para mostrar uma lista de assinaturas, usando o ID de cada assinatura como uma chave. Na resposta, a propriedade id de cada item identifica o ID da assinatura que identifica exclusivamente a assinatura correspondente. Você vai usar esse valor para remover um item da lista na próxima etapa.

• Etapa 2: excluir uma assinatura

  Chame o método subscriptions.delete para excluir uma assinatura. Defina o parâmetro id da solicitação como o ID da assinatura que você quer remover. Essa solicitação precisa ser autorizada usando o OAuth 2.0.

  Para concluir a solicitação no APIs Explorer, você precisa definir o valor da propriedade id.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.delete?
          id=SUBSCRIPTION_ID

Consulte a documentação do método subscriptions.delete para conferir exemplos de código.

Para recuperar uma lista de canais que se inscrevem no canal do usuário autenticado, chame o método subscriptions.list e defina o valor do parâmetro mySubscribers como true. A solicitação precisa ser autorizada usando o OAuth 2.0.

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