Comments: setModerationStatus

Legt den Moderationsstatus für einen oder mehrere Kommentare fest. Die API-Anfrage muss vom Inhaber des Kanals oder des Videos autorisiert werden, der mit den Kommentaren verknüpft ist.

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

Gängige Anwendungsfälle

Anfragen

HTTP-Anfrage

POST https://www.googleapis.com/youtube/v3/comments/setModerationStatus

Autorisierung

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

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

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
id string
Der Parameter id gibt eine durch Kommas getrennte Liste von IDs an, die die Kommentare identifizieren, für die Sie den Moderationsstatus aktualisieren.
moderationStatus string
Erkennt den neuen Moderationsstatus der angegebenen Kommentare.

Zulässige Werte sind:
  • heldForReview: Kennzeichnet einen Kommentar als zur Überprüfung durch einen Moderator ausstehend.
  • published: Löscht einen Kommentar für die öffentliche Anzeige.
  • rejected: Damit wird der Kommentar abgelehnt, weil er nicht angezeigt werden kann. Dadurch werden auch alle Antworten auf den abgelehnten Kommentar ausgeblendet.
Optionale Parameter
banAuthor boolean
Mit dem Parameter banAuthor können Sie angeben, dass zusätzliche Kommentare des Verfassers des Kommentars automatisch abgelehnt werden sollen. Setze den Parameterwert auf true, um den Autor zu sperren.

Hinweis:Dieser Parameter ist nur gültig, wenn auch der Parameter moderationStatus auf rejected gesetzt ist.

Anfragetext

Geben Sie beim Aufrufen dieser Methode keinen Anfragetext an.

Antwort

Wenn der Vorgang erfolgreich ist, gibt diese Methode einen 204-HTTP-Antwortcode (No Content) zurück.

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) banWithoutReject Der Parameter banAuthor kann nur verwendet werden, wenn der Wert des Parameters moderationStatus rejected ist.
badRequest (400) operationNotSupported Kommentare, die nicht auf Google+ basieren, bieten nur eingeschränkte Moderationsfunktionen.
badRequest (400) processingFailure Der API-Server konnte die Anfrage nicht verarbeiten. Dies kann zwar ein vorübergehender Fehler sein, weist jedoch in der Regel darauf hin, dass die Eingabe der Anfrage ungültig ist.
forbidden (403) forbidden Der Moderationsstatus für einen oder mehrere Kommentare kann aufgrund unzureichender Berechtigungen nicht festgelegt werden. Die Anfrage ist möglicherweise nicht korrekt autorisiert.
notFound (404) commentNotFound Mindestens einer der Kommentare, die in der Anfrage aktualisiert werden sollen, wurde nicht gefunden. Prüfen Sie, ob die Werte des id-Parameters der Anfrage korrekt sind.

Jetzt testen

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