Subscriptions: insert

Adiciona uma inscrição para o canal do usuário autenticado.

Impacto da cota:uma chamada para esse método tem um custo de cota de 50 unidades.

Casos de uso comuns

Solicitação

Solicitação HTTP

POST https://www.googleapis.com/youtube/v3/subscriptions

Autorização

Esta solicitação requer autorização com pelo menos um dos seguintes escopos (leia mais sobre autenticação e autorização).

Escopo
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parâmetros

A tabela a seguir lista os parâmetros compatíveis com essa consulta. Todos os parâmetros listados são os parâmetros de consulta.

Parâmetros
Parâmetros obrigatórios
part string
O parâmetro part tem duas finalidades nesta operação. Ele identifica as propriedades que a operação de gravação vai definir, bem como as propriedades que a resposta da API vai incluir.

A lista a seguir contém os nomes de part que podem ser incluídos no valor do parâmetro:
  • contentDetails
  • id
  • snippet
  • subscriberSnippet

Corpo da solicitação

Forneça um recurso de inscrição no corpo da solicitação. Para esse recurso:

  • É necessário especificar um valor para essas propriedades:

    • snippet.resourceId

  • Você pode definir valores para estas propriedades:

    • snippet.resourceId

Resposta

Se for bem-sucedido, este método retorna um recurso de inscrição no corpo da resposta.

Erros

A tabela a seguir identifica mensagens de erro que a API pode retornar em resposta a uma chamada para esse método. Consulte a documentação mensagem de erro para mais detalhes.

Tipo de erro Detalhe do erro Descrição
badRequest (400) subscriptionDuplicate A inscrição que você está tentando criar já existe.
badRequest (400) subscriptionForbidden Você atingiu o número máximo de inscrições.
badRequest (400) subscriptionForbidden Não é possível se inscrever no seu próprio canal.
badRequest (400) subscriptionForbidden Excesso de inscrições recentes. Tente novamente em algumas horas.
forbidden (403) subscriptionForbidden A solicitação não está devidamente autenticada ou não é suportada para este canal.
notFound (404) publisherNotFound O recurso especificado pela propriedade snippet.resourceId da solicitação não foi encontrado.
notFound (404) subscriberNotFound O assinante identificado com a solicitação não pode ser encontrado.
required (400) publisherRequired O recurso de inscrição especificado na solicitação precisa usar a propriedade snippet.resourceId para identificar o canal que está sendo inscrito.

Confira!

Use o APIs Explorer para chamar essa API e conferir a solicitação e a resposta da API.