Videos: reportAbuse

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 string
Esse 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 string
Identifica o vídeo que está sendo denunciado por conter conteúdo abusivo. Defina o valor como o ID do vídeo do YouTube.
reasonId object
Especifica o motivo da denúncia por conteúdo abusivo. Defina o valor como o unique ID do recurso videoAbuseReportReason apropriado.
secondaryReasonId object
Especifica 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 string
Fornece informações adicionais que o informante quer adicionar.
language object
Identifica 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.