Activities: insert

O YouTube suspendeu o uso do recurso de boletim de canal, e esse método não está mais disponível.

Para mais detalhes, acesse a Central de Ajuda do YouTube.

Mensagens de um boletim para um canal específico O usuário que envia a solicitação precisa ter autorização para agir em nome do canal.

Observação: embora um recurso activity possa conter informações sobre ações, como classificar um vídeo ou marcar um vídeo como favorito, você precisa usar outros métodos de API para gerar esses recursos activity. Por exemplo, você usaria o método videos.rate() da API para classificar um vídeo e o método playlistItems.insert() para marcar um vídeo como favorito.

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

Solicitação

Solicitação HTTP

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

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/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. Ela identifica as propriedades que a operação de gravação definirá e as propriedades que a resposta da API incluirá.

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

Corpo da solicitação

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

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

    • snippet.description

  • Você pode definir valores para estas propriedades:

    • snippet.description
    • contentDetails.bulletin.resourceId

Resposta

Se for bem-sucedido, este método retorna um recurso de atividade 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) bulletinTextRequired A solicitação precisa usar a propriedade description do objeto snippet para fornecer o texto da postagem do boletim.
badRequest (400) invalidMetadata A propriedade kind não corresponde ao tipo de ID informado.
forbidden (403) forbidden A solicitação não foi autorizada corretamente.
notFound (404) playlistNotFound O YouTube não consegue encontrar o vídeo que você está tentando associar à postagem do boletim. Verifique o valor da propriedade contentDetails.bulletinPosted.playlistId.
notFound (404) videoNotFound O YouTube não consegue encontrar o vídeo que você está tentando associar à postagem do boletim. Verifique o valor da propriedade contentDetails.bulletinPosted.videoId.
userRateLimitExceeded (403) rateLimitExceeded A solicitação não pode ser concluída porque você excedeu sua cota.