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