Esta página foi traduzida pela API Cloud Translation.

Implementação: assinaturas

Os exemplos a seguir mostram como usar a API Data do YouTube (v3) para realizar funções relacionadas a assinaturas.

Extrair as inscrições de um canal

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.

Adicione uma assinatura

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.

Excluir uma inscrição

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.

Extrair uma lista de inscritos no canal do usuário autorizado

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