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:
|
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. |