Videos: reportAbuse

Video mit missbräuchlichen Inhalten melden

Kontingentauswirkung: Ein Aufruf dieser Methode hat Kontingentkosten von 50 Einheiten.

Anfragen

HTTP-Anfrage

POST https://www.googleapis.com/youtube/v3/videos/reportAbuse

Autorisierung

Diese Anfrage benötigt eine Autorisierung mit mindestens einem der folgenden Bereiche (weitere Informationen zu Authentifizierung und Autorisierung).

Bereich
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

Parameter

In der folgenden Tabelle sind die Parameter aufgeführt, die von dieser Abfrage unterstützt werden. Alle aufgeführten Parameter sind Abfrageparameter.

Parameter
Optionale Parameter
onBehalfOfContentOwner string
Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden. Hinweis: Dieser Parameter ist ausschließlich für YouTube-Contentpartner vorgesehen.

Der Parameter onBehalfOfContentOwner gibt an, dass durch die Autorisierungsanmeldedaten der Anfrage ein YouTube CMS-Nutzer identifiziert wird, der im Namen des im Parameterwert angegebenen Rechteinhabers handelt. Dieser Parameter ist für YouTube-Content-Partner vorgesehen, die viele verschiedene YouTube-Kanäle besitzen und verwalten. Rechteinhaber können sich nur einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Authentifizierungsdaten angeben zu müssen. Das CMS-Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft sein.

Anfragetext

Der Anfragetext hat die folgende Datenstruktur:

{
  "videoId": string,
  "reasonId": string,
  "secondaryReasonId": string,
  "comments": string,
  "language": string
}

Erforderliche Properties

Sie müssen Werte für die folgenden Attribute festlegen:

Optionale Attribute

Sie können Werte für die folgenden Attribute festlegen:

Attribute

In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource angezeigt werden:

Attribute
videoId string
Identifiziert das Video, das wegen missbräuchlicher Inhalte gemeldet wurde. Legen Sie als Wert die YouTube-Video-ID dieses Videos fest.
reasonId object
Gibt den Grund an, warum das gemeldete Video missbräuchliche Inhalte enthält. Legen Sie den Wert auf unique ID der entsprechenden videoAbuseReportReason-Ressource fest.
secondaryReasonId object
Gibt den sekundären Grund an, warum das gemeldete Video missbräuchliche Inhalte enthält. Ein sekundärer Grund enthält eine genauere Beschreibung der anstößigen Inhalte als der Hauptgrund, den die reasonId-Property angibt. Legen Sie als Wert den unique ID des entsprechenden sekundären Grunds fest.
comments string
Stellt zusätzliche Informationen bereit, die der Melder hinzufügen möchte.
language object
Bezeichnet die vom Melder gesprochene Sprache.

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode ein HTTP-204-Antwortcode (No Content) zurückgegeben.

Fehler

In der folgenden Tabelle sind Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben könnte. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) invalidAbuseReason Die Anfrage enthielt einen unerwarteten Wert für das Attribut reasonId oder eine ungültige Kombination der Attribute reasonId und secondaryReasonId.
badRequest (400) rateLimitExceeded Der Nutzer hat zu viele Anfragen in einem bestimmten Zeitraum gesendet.
forbidden (403) forbidden
notFound (404) videoNotFound Das Video, für das du Missbrauch melden möchtest, wurde nicht gefunden.

Jetzt testen

Verwenden Sie APIs Explorer, um diese API aufzurufen und die API-Anfrage und -Antwort anzusehen.