Comments: setModerationStatus

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

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

Permiso
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 de ID separados por comas 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.
  • rejected: Rechaza un comentario por no ser apto para mostrarse. Esta acción también oculta eficazmente todas las respuestas al comentario rechazado.
Parámetros opcionales
banAuthor boolean
El parámetro banAuthor te permite indicar que quieres rechazar automáticamente cualquier comentario adicional que haya escrito el autor del comentario. Establece el valor del parámetro en true para bloquear al autor.

Nota: Este parámetro solo es válido si el parámetro moderationStatus también se establece en rejected.

Cuerpo de la solicitud

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

Respuesta

Si se aplica 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 no basados en Google+ ofrecen una funcionalidad de moderación limitada.
badRequest (400) processingFailure El servidor de la API no pudo procesar la solicitud correctamente. Aunque puede ser un error transitorio, generalmente indica que la entrada de la solicitud no es válida.
forbidden (403) forbidden No se puede establecer el estado de moderación de uno o más comentarios porque no tienes los permisos necesarios. Puede que la solicitud no esté debidamente autorizada.
notFound (404) commentNotFound No se pueden encontrar uno o más de los comentarios que la solicitud intenta actualizar. Comprueba los valores del parámetro id de la solicitud para asegurarte de que sean correctos.

Pruébala

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