Comments: setModerationStatus

Définit l'état de modération d'un ou de plusieurs commentaires. La requête API doit être autorisée par le propriétaire de la chaîne ou de la vidéo associée aux commentaires.

Impact sur le quota : un appel à cette méthode coûte 50 unités de quota.

Cas d'utilisation courants

Requête

Requête HTTP

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

Autorisation

Une autorisation est requise pour cette requête. Celle-ci doit inclure au moins l'un des champs d'application suivants. En savoir plus sur le processus d'authentification et d'autorisation

Champ d'application
https://www.googleapis.com/auth/youtube.force-ssl

Paramètres

Le tableau suivant répertorie les paramètres compatibles avec cette requête. Tous les paramètres listés sont des paramètres de requête.

Paramètres
Paramètres obligatoires
id	string Le paramètre id spécifie une liste d'au maximum 50 ID séparés par une virgule qui identifient les commentaires dont vous mettez à jour l'état de modération.
moderationStatus	string Identifie le nouvel état de modération des commentaires spécifiés. Les valeurs acceptables sont les suivantes : heldForReview : marque un commentaire comme étant en attente de modération. published : autorise l'affichage public d'un commentaire. Vous ne pouvez pas modifier l'état de modération d'un commentaire refusé en published. rejected : refuse un commentaire, car il n'est pas adapté à l'affichage. Cette action masque également toutes les réponses au commentaire refusé. Pour supprimer un commentaire rédigé par un autre utilisateur de votre chaîne ou de votre vidéo, définissez son état de modération sur rejected. La méthode comments.delete ne peut être utilisée que par l'auteur original du commentaire.
Paramètres facultatifs
banAuthor	boolean Le paramètre banAuthor vous permet d'indiquer que vous souhaitez refuser automatiquement tous les commentaires supplémentaires écrits par l'auteur du commentaire. Définissez la valeur du paramètre sur true pour bannir l'auteur. Ce paramètre n'est valide que si le paramètre moderationStatus est également défini sur rejected.

Corps de la requête

Ne fournissez pas de corps de requête lorsque vous appelez cette méthode.

Réponse

En cas de réussite, cette méthode renvoie un code de réponse HTTP 204 (No Content).

Erreurs

Le tableau suivant identifie les messages d'erreur que l'API peut renvoyer en réponse à un appel à cette méthode. Pour en savoir plus, consultez la documentation sur les messages d'erreur.

Type d'erreur	Détails de l'erreur	Description
badRequest (400)	banWithoutReject	Le paramètre banAuthor ne peut être utilisé que si la valeur de paramètre moderationStatus est rejected.
badRequest (400)	operationNotSupported	Les commentaires qui ne sont pas basés sur Google+ n'offrent que des fonctionnalités de modération limitées.
badRequest (400)	processingFailure	Le serveur d'API n'a pas réussi à traiter la requête. Bien qu'il puisse s'agir d'une erreur temporaire, elle indique généralement que l'entrée de la requête n'est pas valide. Cette erreur est également renvoyée lorsque vous tentez de modérer un commentaire qui a déjà été supprimé par l'auteur original.
forbidden (403)	forbidden	L'état de modération d'un ou de plusieurs commentaires ne peut pas être défini en raison d'autorisations insuffisantes. La requête n'est peut-être pas autorisée. Cette erreur est également renvoyée lorsque vous tentez de modérer un ID de commentaire supprimé ou non valide.
notFound (404)	commentNotFound	Un ou plusieurs commentaires que la requête tente de mettre à jour sont introuvables. Vérifiez les valeurs du paramètre id de la requête pour vous assurer qu'elles sont correctes.

Essayer

Utilisez le APIs Explorer pour appeler cette API et afficher la requête et la réponse.