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.