Eine Liste mit Gründen abrufen, die zum Melden missbräuchlicher Videos verwendet werden können.
Auswirkungen auf das Kontingent:Ein Aufruf dieser Methode kostet 1 Kontingenteinheit.
Gängige Anwendungsfälle
Anfrage
HTTP-Anfrage
GET https://www.googleapis.com/youtube/v3/videoAbuseReportReasons
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/youtube.readonly |
Parameter
In der folgenden Tabelle sind die Parameter aufgeführt, die von dieser Abfrage unterstützt werden. Alle aufgeführten Parameter sind Abfrageparameter.
| Parameter | ||
|---|---|---|
| Erforderliche Parameter | ||
part |
stringMit dem Parameter part werden die Teile der Ressource videoAbuseReportReason angegeben, die in der API-Antwort enthalten sein sollen. Unterstützte Werte sind id und snippet. |
|
| Optionale Parameter | ||
hl |
stringMit dem Parameter hl wird die Sprache angegeben, die für Textwerte in der API-Antwort verwendet werden soll. Der Standardwert ist en_US. |
|
Anfragetext
Geben Sie beim Aufrufen dieser Methode keinen Anfragetext an.
Antwort
Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:
{
"kind": "youtube#videoAbuseReportReasonListResponse",
"etag": etag,
"items": [
videoAbuseReportReason resource
]
}Attribute
In der folgenden Tabelle sind die Attribute definiert, die in dieser Ressource enthalten sind:
| Attribute | |
|---|---|
kind |
stringGibt den Typ der API-Ressource an. Der Wert ist youtube#videoAbuseReportReasonListResponse. |
etag |
etagDas ETag dieser Ressource. |
items[] |
listEine Liste von videoAbuseReportReason-Ressourcen, die jeweils einen Grund angeben, aus dem ein Video wegen missbräuchlicher Inhalte gemeldet werden kann. Verwenden Sie diese Informationen, wenn Sie die Methode videos.reportAbuse aufrufen, um Videos mit missbräuchlichen Inhalten tatsächlich zu melden. |
Fehler
In der folgenden Tabelle sind die Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben kann. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.
| Fehlertyp | Fehlerdetails | Beschreibung |
|---|---|---|
forbidden (403) |
forbidden |
Testen!
Mit dem APIs Explorer können Sie diese API aufrufen und die API-Anfrage und -Antwort ansehen.