Denuncia um vídeo por conter conteúdo abusivo.
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/videos/reportAbuse
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 |
https://www.googleapis.com/auth/youtubepartner |
Parâmetros
A tabela a seguir lista os parâmetros que esta consulta suporta. Todos os parâmetros listados são os parâmetros de consulta.
| Parâmetros | ||
|---|---|---|
| Parâmetros opcionais | ||
onBehalfOfContentOwner | stringEsse parâmetro só pode ser usado em uma solicitação autorizada. Observação:esse parâmetro é destinado exclusivamente a parceiros de conteúdo do YouTube. O parâmetro onBehalfOfContentOwner indica que as credenciais de autorização da solicitação identificam um usuário do CMS do YouTube que está agindo em nome do proprietário do conteúdo especificado no valor do parâmetro. Este parâmetro destina-se a parceiros de conteúdo do YouTube que possuem e gerenciam vários canais do YouTube diferentes. Ele permite que os proprietários de conteúdo autentiquem uma vez e tenham acesso a todos os dados de seu canal e de seus vídeos sem ter que fornecer credenciais de autenticação para cada canal. A conta do CMS com a qual o usuário autentica deve estar vinculada ao proprietário do conteúdo do YouTube especificado. | |
Corpo da solicitação
O corpo da solicitação tem a seguinte estrutura de dados:
{
"videoId": string,
"reasonId": string,
"secondaryReasonId": string,
"comments": string,
"language": string
}Propriedades obrigatórias
É necessário definir valores para as seguintes propriedades:
Propriedades opcionais
É possível definir valores para as seguintes propriedades:
Propriedades
A tabela a seguir define as propriedades que aparecem neste recurso:
| Propriedades | |
|---|---|
videoId | stringIdentifica o vídeo que está sendo denunciado por conter conteúdo abusivo. Defina o valor como o ID do vídeo do YouTube. |
reasonId | objectEspecifica o motivo da denúncia por conteúdo abusivo. Defina o valor como o unique ID do recurso videoAbuseReportReason apropriado. |
secondaryReasonId | objectEspecifica o motivo secundário para a denúncia de conteúdo abusivo do vídeo. Um motivo secundário fornece uma descrição mais específica do conteúdo inadequado do que o motivo principal, que é identificado pela propriedade reasonId. Defina o valor como unique ID do motivo secundário adequado. |
comments | stringFornece informações adicionais que o informante quer adicionar. |
language | objectIdentifica um idioma falado pelo repórter. |
Resposta
Se for bem-sucedido, esse método vai retornar um código de resposta HTTP 204 (No Content).
Erros
A tabela abaixo identifica as mensagens de erro que a API pode retornar em resposta a uma chamada para este método. Consulte a documentação mensagem de erro para mais detalhes.
| Tipo de erro | Detalhe do erro | Descrição |
|---|---|---|
badRequest (400) | invalidAbuseReason | A solicitação continha um valor inesperado para a propriedade reasonId ou uma combinação inválida das propriedades reasonId e secondaryReasonId. |
badRequest (400) | rateLimitExceeded | O usuário enviou muitas solicitações em um determinado período. |
forbidden (403) | forbidden | |
notFound (404) | videoNotFound | Não foi possível encontrar o vídeo que você está tentando denunciar. |
Confira!
Use APIs Explorer para chamar essa API e conferir a solicitação e a resposta dela.