Comments: setModerationStatus

Establece el estado de moderación de uno o más comentarios. El propietario del canal o del video asociado con los comentarios debe autorizar la solicitud a la API.

Impacto en la cuota: Una llamada a este método tiene un costo de cuota de 50 unidades.

Casos de uso habituales

Solicitud

Solicitud HTTP

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

Autorización

Esta solicitud requiere autorización con al menos uno de los siguientes alcances (obtén más información acerca de la autenticación y autorización).

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

Parámetros

En la siguiente tabla, se enumeran los parámetros que admite esta consulta. Todos los parámetros mencionados son parámetros de consulta.

Parámetros
Parámetros obligatorios
id string
El parámetro id especifica una lista separada por comas de hasta 50 IDs que identifican los comentarios para los que estás actualizando el estado de moderación.
moderationStatus string
Identifica el nuevo estado de moderación de los comentarios especificados.

Los valores aceptables son los siguientes:
  • heldForReview : Marca un comentario como pendiente de revisión por parte de un moderador.
  • published : Borra un comentario para que se muestre públicamente. No puedes cambiar el estado de moderación de un comentario rechazado a published.
  • rejected : Rechaza un comentario por no ser apto para mostrarse. Esta acción también oculta de manera efectiva todas las respuestas al comentario rechazado. Para quitar un comentario escrito por otro usuario de tu canal o video, establece su estado de moderación en rejected. El método comments.delete solo puede usarlo el autor original del comentario.
Parámetros opcionales
banAuthor boolean
El parámetro banAuthor te permite indicar que deseas rechazar automáticamente cualquier comentario adicional escrito por el autor del comentario. Establece el valor del parámetro en true para prohibir al autor.

Este parámetro solo es válido si el parámetro moderationStatus también está establecido en rejected.

Cuerpo de la solicitud

No proporciones un cuerpo de solicitud cuando invoques este método.

Respuesta

Si se ejecuta correctamente, este método muestra un código de respuesta HTTP 204 (No Content).

Errores

En la siguiente tabla, se identifican los mensajes de error que la API podría mostrar en respuesta a una llamada a este método. Consulta la documentación sobre mensajes de error para obtener más información.

Tipo de error Detalle del error Descripción
badRequest (400) banWithoutReject El parámetro banAuthor solo se puede usar si el valor del parámetro moderationStatus es rejected.
badRequest (400) operationNotSupported Los comentarios que no se basan en Google+ solo ofrecen una funcionalidad de moderación limitada.
badRequest (400) processingFailure El servidor de la API no pudo procesar la solicitud correctamente. Si bien puede ser un error transitorio, suele indicar que la entrada de la solicitud no es válida. Este error también se muestra cuando se intenta moderar un comentario que ya borró el comentarista original.
forbidden (403) forbidden No se puede establecer el estado de moderación de uno o más comentarios debido a que no se tienen los permisos suficientes. Es posible que la solicitud no esté autorizada. Este error también se muestra cuando se intenta moderar un ID de comentario borrado o no válido.
notFound (404) commentNotFound No se pueden encontrar uno o más de los comentarios que la solicitud intenta actualizar. Verifica los valores del parámetro id de la solicitud para asegurarte de que sean correctos.

Pruébalo

Usa el APIs Explorer para llamar a esta API y ver la solicitud a la API y la respuesta.