Cette page a été traduite par l'API Cloud Translation.

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.