Videos: reportAbuse

Denuncia um vídeo por apresentar conteúdo abusivo.

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/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 string
Esse parâmetro só pode ser usado em uma solicitação autorizada corretamente. 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

Defina 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 string
Identifica o vídeo denunciado por conter conteúdo abusivo. Defina o valor como o ID do vídeo do YouTube.
reasonId object
Especifica o motivo pelo qual o vídeo está sendo denunciado por apresentar conteúdo abusivo. Defina o valor como o unique ID do recurso videoAbuseReportReason.
secondaryReasonId object
Especifica o motivo secundário de denúncia de conteúdo abusivo. Um motivo secundário fornece uma descrição mais específica do conteúdo censurável do que o motivo principal, que a propriedade reasonId identifica. Defina o valor como o unique ID do motivo secundário apropriado.
comments string
Apresente outras informações que o informante queira adicionar.
language object
Identifica um idioma falado pelo repórter.

Resposta

Se for bem-sucedido, esse método retorna 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 O vídeo em que você está tentando denunciar abuso não foi encontrado.

Confira!

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