Videos: reportAbuse

Denunciar 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 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 atua 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

É preciso definir os valores das 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 apresentar conteúdo abusivo. Defina o valor do 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 apropriado.
secondaryReasonId object
Especifica o motivo secundário pelo qual o vídeo está sendo denunciado por apresentar 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 para o unique ID do motivo secundário apropriado.
comments string
Fornece mais informações que o repórter quer adicionar.
language object
Identifica o idioma falado pelo denunciante.

Resposta

Se for bem-sucedido, este método 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 tinha 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 para o qual você está tentando denunciar abuso não foi encontrado.

Confira!

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