Comments: setModerationStatus

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

Impact sur les quotas:un appel à cette méthode entraîne un coût du quota de 50 unités.

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

Définition du 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 répertoriés sont des paramètres de requête.

Paramètres
Paramètres obligatoires
id string
Le paramètre id spécifie une liste d'ID séparés par une virgule, qui identifient les commentaires pour lesquels vous mettez à jour l'état de modération.
moderationStatus string
Identifie le nouvel état de modération des commentaires spécifiés.

Valeurs acceptées :
  • heldForReview : marque un commentaire comme en attente d'examen par un modérateur.
  • published : efface un commentaire pour l'afficher publiquement.
  • rejected : le commentaire est refusé, car il ne peut pas être affiché. De plus, toutes les réponses au commentaire refusé sont masquées.
Paramètres facultatifs
banAuthor boolean
Le paramètre banAuthor vous permet d'indiquer que vous souhaitez rejeter automatiquement tout commentaire supplémentaire rédigé par l'auteur du commentaire. Définissez la valeur du paramètre sur true pour bannir l'auteur.

Remarque: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

Lorsque cette méthode fonctionne, elle 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 du paramètre moderationStatus est rejected.
badRequest (400) operationNotSupported Les commentaires qui ne sont pas basés sur Google+ n'offrent qu'une fonctionnalité de modération limitée.
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.
forbidden (403) forbidden Impossible de définir l'état de modération d'un ou de plusieurs commentaires en raison d'autorisations insuffisantes. La requête ne dispose peut-être pas des autorisations appropriées.
notFound (404) commentNotFound Un ou plusieurs des commentaires que la demande tente de mettre à jour sont introuvables. Vérifiez que les valeurs du paramètre id de la requête sont correctes.

Essayer

Utilisez APIs Explorer pour appeler cette API, et afficher la requête et la réponse de l'API.