Comments: setModerationStatus

Legt den Moderationsstatus eines oder mehrerer Kommentare fest. Die API-Anfrage muss vom Inhaber des Kanals oder Videos autorisiert werden, der bzw. das mit den Kommentaren verknüpft ist.

Auswirkungen auf das Kontingent:Ein Aufruf dieser Methode kostet 50 Kontingenteinheiten.

Gängige Anwendungsfälle

Anfrage

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).

Bereich
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 mit bis zu 50 IDs an, die die Kommentare identifizieren, für die Sie den Moderationsstatus aktualisieren.
moderationStatus string
Gibt den neuen Moderationsstatus der angegebenen Kommentare an.

Zulässige Werte:
  • heldForReview – Markiert einen Kommentar als zur Überprüfung durch einen Moderator ausstehend.
  • published – Gibt einen Kommentar zur öffentlichen Anzeige frei. Sie können den Moderationsstatus eines abgelehnten Kommentars nicht in published ändern.
  • rejected – Lehnt einen Kommentar ab, weil er nicht zur Anzeige geeignet ist. Durch diese Aktion werden auch alle Antworten auf den abgelehnten Kommentar ausgeblendet. Wenn Sie einen Kommentar eines anderen Nutzers von Ihrem Kanal oder Video entfernen möchten, legen Sie den Moderationsstatus auf rejected fest. Die Methode comments.delete kann nur vom ursprünglichen Autor des Kommentars verwendet werden.
Optionale Parameter
banAuthor boolean
Mit dem Parameter banAuthor können Sie angeben, dass Sie alle weiteren Kommentare des Autors automatisch ablehnen möchten. Legen Sie den Parameterwert auf true fest, um den Autor zu sperren.

Dieser Parameter ist nur gültig, wenn der Parameter moderationStatus ebenfalls auf rejected gesetzt ist.

Anfragetext

Geben Sie beim Aufrufen dieser Methode keinen Anfragetext an.

Antwort

Bei Erfolg gibt diese Methode den HTTP-Antwortcode 204 (No Content) zurück.

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
badRequest (400) banWithoutReject Der Parameter banAuthor kann nur verwendet werden, wenn der Parameterwert 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 ein vorübergehender Fehler sein, deutet aber in der Regel darauf hin, dass die Eingabe der Anfrage ungültig ist. Dieser Fehler wird auch zurückgegeben, wenn versucht wird, einen Kommentar zu moderieren, der bereits vom ursprünglichen Kommentator gelöscht wurde.
forbidden (403) forbidden Der Moderationsstatus eines oder mehrerer Kommentare kann aufgrund unzureichender Berechtigungen nicht festgelegt werden. Die Anfrage ist möglicherweise nicht autorisiert. Dieser Fehler wird auch zurückgegeben, wenn versucht wird, eine gelöschte oder ungültige Kommentar-ID zu moderieren.
notFound (404) commentNotFound Mindestens einer der Kommentare, die mit der Anfrage aktualisiert werden sollen, wurde nicht gefunden. Prüfen Sie, ob die Werte des Parameters id der Anfrage korrekt sind.

Testen!

Mit dem APIs Explorer können Sie diese API aufrufen und die API-Anfrage und -Antwort ansehen.