Activities: insert

O YouTube suspendeu o uso do recurso de boletim de canais, que não é mais compatível.

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

Mensagens de um boletim para um canal específico O usuário que enviar a solicitação deve 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, é necessário usar outros métodos de API para gerar esses recursos activity. Por exemplo, você pode usar 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 da 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. 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

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 fornecido.
forbidden (403) forbidden A solicitação não está devidamente autorizada.
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.